@automagik/omni 2.260906.3 → 2.260906.5

package/db/drizzle/0058_omni_events_causation_id.sql

@@ -0,0 +1,24 @@
+-- causationId in the persisted event journal (#957, RFC #925 G3 feature half).
+--
+-- `metadata->correlationId` groups a flow (the bag of events); `causation_id`
+-- gives the tree — the id of the IMMEDIATE parent event whose consumption
+-- caused this one to be published. NULL for root events (external ingress
+-- mints a fresh correlation, no parent) and for every pre-existing row
+-- (forward-only: the ~349k historical journal events have no derivable
+-- parent, no backfill). Not an FK — the parent may never have been persisted
+-- or may have been pruned.
+--
+-- The index serves the `omni events trace` descendants walk
+-- (children = rows WHERE causation_id = :id).
+--
+-- Hand-written following the 0055_asc_flow_handoff_mode precedent (additive,
+-- idempotent — the snapshot chain stops at 0026 so drizzle-kit generate is
+-- not usable here). No explicit BEGIN/COMMIT — the boot migrator executes
+-- this file on a pooled postgres-js connection, which rejects raw transaction
+-- control. ADD COLUMN with no default does not rewrite the table.
+
+ALTER TABLE "omni_events"
+  ADD COLUMN IF NOT EXISTS "causation_id" uuid;
+
+CREATE INDEX IF NOT EXISTS "omni_events_causation_idx"
+  ON "omni_events" ("causation_id");

package/db/drizzle/0059_ingress_idempotency.sql

@@ -0,0 +1,55 @@
+-- Ingress idempotency (#958, RFC #925 G2).
+--
+-- `WebhooksService.receive()` published a fresh event on every request with
+-- no dedup anywhere on the path, so a provider redelivery (same GitHub
+-- delivery id, 400ms apart) became two events → two automation firings →
+-- duplicate destination rows. The fix: THE DATABASE dedupes via a unique
+-- index, not application logic.
+--
+--   omni_events.idempotency_key   text, NULL for internal events without a
+--                                 derivation (forward-only: the existing rows
+--                                 have no reliably derivable key and stay
+--                                 NULL). Webhook ingress claims the key by
+--                                 inserting the journal row BEFORE publishing;
+--                                 an ON CONFLICT miss means redelivery — the
+--                                 emitter is acked (200) and no event exists.
+--                                 Automation emit_event re-publishes claim
+--                                 `derived:{parent_event_id}:{automation_id}:{action_index}`.
+--
+--   omni_events.event_type        widened 50 → 255: journaled webhook events
+--                                 are typed `custom.webhook.{source}` and the
+--                                 source name alone may be 100 chars.
+--
+--   webhook_sources.idempotency_key_template
+--                                 per-source key derivation template;
+--                                 existing sources migrate onto the body-hash
+--                                 default `{source}:{sha256(body)}`.
+--   webhook_sources.total_duplicates
+--                                 redeliveries acked without a second event.
+--
+-- Index pair follows the additive-tenancy pattern of webhook_sources' name
+-- indexes: a plain global unique (the ON CONFLICT target through the additive
+-- phase) plus a tenant-scoped partial that positions RLS enforcement.
+-- Postgres treats NULLs as distinct, so legacy rows never collide.
+--
+-- Hand-written following the 0052-0055 precedent (snapshot drift keeps
+-- drizzle-kit generate interactive). Additive + idempotent. No explicit
+-- BEGIN/COMMIT — the boot migrator executes this file on a pooled postgres-js
+-- connection, which rejects raw transaction control.
+
+ALTER TABLE "omni_events" ADD COLUMN IF NOT EXISTS "idempotency_key" text;
+
+ALTER TABLE "omni_events" ALTER COLUMN "event_type" TYPE varchar(255);
+
+CREATE UNIQUE INDEX IF NOT EXISTS "omni_events_idempotency_key_uq"
+  ON "omni_events" ("idempotency_key");
+
+CREATE UNIQUE INDEX IF NOT EXISTS "omni_events_tenant_idempotency_key_uq"
+  ON "omni_events" ("tenant_id", "idempotency_key")
+  WHERE "tenant_id" IS NOT NULL AND "idempotency_key" IS NOT NULL;
+
+ALTER TABLE "webhook_sources"
+  ADD COLUMN IF NOT EXISTS "idempotency_key_template" text NOT NULL DEFAULT '{source}:{sha256(body)}';
+
+ALTER TABLE "webhook_sources"
+  ADD COLUMN IF NOT EXISTS "total_duplicates" integer NOT NULL DEFAULT 0;

package/db/drizzle/meta/_journal.json

@@ -407,6 +407,20 @@
       "when": 1785700000000,
       "tag": "0057_connector_lifecycle_contract",
       "breakpoints": true
+    },
+    {
+      "idx": 58,
+      "version": "7",
+      "when": 1785800000000,
+      "tag": "0058_omni_events_causation_id",
+      "breakpoints": true
+    },
+    {
+      "idx": 59,
+      "version": "7",
+      "when": 1785900000000,
+      "tag": "0059_ingress_idempotency",
+      "breakpoints": true
     }
   ]
 }

package/dist/commands/events.d.ts

@@ -3,11 +3,25 @@
  *
  * omni events list --instance <id>
  * omni events stream [flags]
+ * omni events trace <id>
  * omni events search <query>
  * omni events timeline <person-id>
  */
 import type { Event } from '@omni/sdk';
 import { Command } from 'commander';
+/** One journal row as returned inside a trace response. */
+interface TraceEvent {
+    id: string;
+    eventType: string;
+    receivedAt: string;
+    causationId: string | null;
+    metadata?: {
+        correlationId?: string;
+    } | null;
+    textContent?: string | null;
+}
+/** One human-readable trace line: type, short id, time, correlation. */
+export declare function formatTraceLine(event: TraceEvent, marker: string): string;
 /** A registered event schema as returned by the API. */
 interface EventSchemaData {
     id: string;

package/dist/commands/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/commands/events.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAc,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsMpC,wDAAwD;AACxD,UAAU,eAAe;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,iBAAe,gBAAgB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAe1G;AAED,kFAAkF;AAClF,iBAAS,kBAAkB,CAAC,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUhG;AAED,iBAAS,kBAAkB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzE;AAyED,eAAO,MAAM,WAAW;;;;CAA+D,CAAC;AAoBxF,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,iFAAiF;AACjF,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAQvF;AAED,uDAAuD;AACvD,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAOpD;AA6HD,wBAAgB,mBAAmB,IAAI,OAAO,CAqP7C"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/commands/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAc,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsMpC,2DAA2D;AAC3D,UAAU,UAAU;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7C,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AA+BD,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAKzE;AAyCD,wDAAwD;AACxD,UAAU,eAAe;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,iBAAe,gBAAgB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAe1G;AAED,kFAAkF;AAClF,iBAAS,kBAAkB,CAAC,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUhG;AAED,iBAAS,kBAAkB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzE;AAyED,eAAO,MAAM,WAAW;;;;CAA+D,CAAC;AAoBxF,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,iFAAiF;AACjF,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAQvF;AAED,uDAAuD;AACvD,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAOpD;AA6HD,wBAAgB,mBAAmB,IAAI,OAAO,CAmQ7C"}

package/dist/commands/webhooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../src/commands/webhooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC,UAAU,sBAAsB;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAcD;;;;;GAKG;AACH,iBAAe,sBAAsB,CACnC,OAAO,EAAE,sBAAsB,EAC/B,SAAS,GAAE,MAAM,OAAO,CAAC,MAAM,CAAuB,GACrD,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAqC7B;AAED,6FAA6F;AAC7F,iBAAS,oBAAoB,CAAC,OAAO,EAAE;IACrC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,0BAA0B,GAAG,SAAS,CAczC;AAED;;;;;GAKG;AACH,iBAAS,6BAA6B,CACpC,eAAe,EAAE,0BAA0B,GAAG,SAAS,EACvD,eAAe,EAAE,MAAM,GAAG,SAAS,GAClC,IAAI,CAQN;AA4DD,wBAAgB,qBAAqB,IAAI,OAAO,CA6S/C;AAED,wDAAwD;AACxD,eAAO,MAAM,WAAW;;;;CAAkF,CAAC"}
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../src/commands/webhooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC,UAAU,sBAAsB;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAcD;;;;;GAKG;AACH,iBAAe,sBAAsB,CACnC,OAAO,EAAE,sBAAsB,EAC/B,SAAS,GAAE,MAAM,OAAO,CAAC,MAAM,CAAuB,GACrD,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAqC7B;AAED,6FAA6F;AAC7F,iBAAS,oBAAoB,CAAC,OAAO,EAAE;IACrC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,0BAA0B,GAAG,SAAS,CAczC;AAkDD;;;;;GAKG;AACH,iBAAS,6BAA6B,CACpC,eAAe,EAAE,0BAA0B,GAAG,SAAS,EACvD,eAAe,EAAE,MAAM,GAAG,SAAS,GAClC,IAAI,CAQN;AA4DD,wBAAgB,qBAAqB,IAAI,OAAO,CA8Q/C;AAED,wDAAwD;AACxD,eAAO,MAAM,WAAW;;;;CAAkF,CAAC"}