@automagik/omni 2.260908.4 → 2.260908.6

package/db/drizzle/0061_automation_transactional_emissions.sql

@@ -0,0 +1,26 @@
+-- Per-automation transactional publication flag (issue #988, RFC #925 G5).
+--
+-- The automation executor continues on action failure by design, so an
+-- `emit_event` that ran before a later failed action leaves a partial effect
+-- on the bus — "partial effects on the bus are the default" (RFC #925 G5).
+-- This adds the opt-in per-automation switch:
+--
+--   automations.transactional_emissions   when true, the run's emit_event
+--                                         publishes are accumulated in a
+--                                         run-scoped buffer and flushed IN
+--                                         ORDER only when every action of the
+--                                         run succeeded; a failed/cancelled
+--                                         run publishes zero. The DLQ retry
+--                                         restarts clean and the #958 derived
+--                                         idempotency keys guarantee a
+--                                         successful retry does not duplicate.
+--                                         Default false: existing automations
+--                                         keep today's immediate mid-sequence
+--                                         publishing byte-for-byte.
+--
+-- Hand-written following the 0043/0044/0052 precedent (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 "automations"
+  ADD COLUMN IF NOT EXISTS "transactional_emissions" boolean NOT NULL DEFAULT false;

package/db/drizzle/0062_agent_event_manifest.sql

@@ -0,0 +1,26 @@
+-- Agent event subscription manifest (#985, RFC #925 G4a).
+--
+-- Adds `agents.event_manifest` jsonb: the declarative accepts/publishes
+-- contract for an agent, e.g.
+--
+--   { "accepts":   [{ "event": "custom.clickup.task.status_changed",
+--                     "filter": { "list_id": "901300373349" } }],
+--     "publishes": [{ "event": "custom.review.parecer.ready" }] }
+--
+-- The DB is the source of truth (RFC open question 3); git-versioned files
+-- are applied via `omni agents manifest apply`. Shape is validated by
+-- `AgentEventManifestSchema` in @omni/core at every write boundary. This
+-- slice is storage + read surface only — G4b (#986) compiles `accepts` into
+-- automations, G4c (#987) enforces `publishes` at emission time.
+--
+-- A jsonb column on the existing `agents` row (rather than a dedicated
+-- table) keeps RLS/tenancy untouched: `agents` is already a G2 tenant table
+-- with its policies in place, while a new table would need ownership specs,
+-- RLS policies, and tenant triggers of its own.
+--
+-- Hand-written following the 0043/0044/0052 precedent (additive, idempotent).
+--
+-- NOTE: no explicit BEGIN/COMMIT — the boot migrator executes this file on a
+-- pooled postgres-js connection, which rejects raw transaction control.
+
+ALTER TABLE "agents" ADD COLUMN IF NOT EXISTS "event_manifest" jsonb;

package/db/drizzle/meta/_journal.json

@@ -428,6 +428,20 @@
       "when": 1786000000000,
       "tag": "0060_webhook_source_strict_schemas",
       "breakpoints": true
+    },
+    {
+      "idx": 61,
+      "version": "7",
+      "when": 1786100000000,
+      "tag": "0061_automation_transactional_emissions",
+      "breakpoints": true
+    },
+    {
+      "idx": 62,
+      "version": "7",
+      "when": 1786200000000,
+      "tag": "0062_agent_event_manifest",
+      "breakpoints": true
     }
   ]
 }

package/dist/commands/agents.d.ts

@@ -8,7 +8,66 @@
  * omni agents update <id> [--name <name>] [--model <model>] [--provider <provider>] [--agent-provider <id>] [--type <type>] [--active|--inactive]
  *                  [--provider-agent-id <id>] [--config-path <path>] [--metadata <json>]
  * omni agents delete <id>
+ * omni agents manifest get <id>
+ * omni agents manifest apply <id> --file <path>
+ * omni agents graph [--type <event>]
  */
+import type { AgentEventManifest } from '@omni/core';
 import { Command } from 'commander';
+/** Detect the manifest file format from its extension (.yaml/.yml → YAML). */
+declare function detectManifestFormat(filePath: string): 'json' | 'yaml';
+/**
+ * Parse a manifest file's contents. YAML is parsed with Bun's built-in
+ * `Bun.YAML` (no extra dependency); JSON with JSON.parse. Throws with a
+ * readable message on parse failure.
+ */
+declare function parseManifestSource(source: string, format: 'json' | 'yaml'): unknown;
+/**
+ * Validate a parsed manifest document against the shared Zod schema
+ * (client-side, before any network call). Throws with per-field messages.
+ */
+declare function validateManifestDocument(raw: unknown): AgentEventManifest;
+/** Minimal agent shape the graph helpers need (matches SDK list output). */
+interface GraphAgentInput {
+    name: string;
+    eventManifest?: {
+        accepts?: {
+            event: string;
+            filter?: Record<string, unknown>;
+        }[];
+        publishes?: {
+            event: string;
+        }[];
+    } | null;
+}
+interface GraphRow {
+    agent: string;
+    consumes: string;
+    produces: string;
+}
+/**
+ * Build the producer/consumer table: one row per agent that declares at least
+ * one accepts/publishes entry. Agents without a manifest are omitted.
+ */
+declare function buildGraphRows(agents: GraphAgentInput[]): GraphRow[];
+interface TypeGraphRow {
+    agent: string;
+    role: 'consumes' | 'produces';
+    filter: string;
+}
+/**
+ * Answer "who listens to / who may emit this event type": one row per
+ * declaration matching the given type.
+ */
+declare function buildTypeRows(agents: GraphAgentInput[], eventType: string): TypeGraphRow[];
+/** Exported for unit tests only. */
+export declare const __testables: {
+    detectManifestFormat: typeof detectManifestFormat;
+    parseManifestSource: typeof parseManifestSource;
+    validateManifestDocument: typeof validateManifestDocument;
+    buildGraphRows: typeof buildGraphRows;
+    buildTypeRows: typeof buildTypeRows;
+};
 export declare function createAgentsCommand(): Command;
+export {};
 //# sourceMappingURL=agents.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/commands/agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoJpC,wBAAgB,mBAAmB,IAAI,OAAO,CAsL7C"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/commands/agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsJpC,8EAA8E;AAC9E,iBAAS,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAE/D;AAED;;;;GAIG;AACH,iBAAS,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAS7E;AAED;;;GAGG;AACH,iBAAS,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,CASlE;AAED,4EAA4E;AAC5E,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE;QACd,OAAO,CAAC,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SAAE,EAAE,CAAC;QAChE,SAAS,CAAC,EAAE;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KACjC,GAAG,IAAI,CAAC;CACV;AAED,UAAU,QAAQ;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAQD;;;GAGG;AACH,iBAAS,cAAc,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,QAAQ,EAAE,CAc7D;AAED,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,UAAU,GAAG,UAAU,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,iBAAS,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,EAAE,CAcnF;AAED,oCAAoC;AACpC,eAAO,MAAM,WAAW;;;;;;CAMvB,CAAC;AAEF,wBAAgB,mBAAmB,IAAI,OAAO,CA0Q7C"}

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

@@ -1 +1 @@
-{"version":3,"file":"automations.d.ts","sourceRoot":"","sources":["../../src/commands/automations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuFpC,wBAAgB,wBAAwB,IAAI,OAAO,CAkTlD"}
+{"version":3,"file":"automations.d.ts","sourceRoot":"","sources":["../../src/commands/automations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0FpC,wBAAgB,wBAAwB,IAAI,OAAO,CAwUlD"}