@automagik/omni 2.260908.8 → 2.260908.9

package/db/drizzle/0063_automation_manifest_provenance.sql

@@ -0,0 +1,32 @@
+-- Manifest-compilation provenance on automations (#986, RFC #925 G4b).
+--
+-- Adds `automations.managed_by_agent_id`: set when the row was COMPILED from
+-- `agents.event_manifest` by the manifest compiler
+-- (packages/api/src/services/manifest-compiler.ts); NULL = hand-made. The
+-- agent's manifest is the source of truth and `automations` becomes the
+-- compiled plan for these rows — the API rejects manual create/update/delete
+-- of a managed automation so the plan cannot drift silently.
+--
+-- The FK is ON DELETE CASCADE so a hard agent delete removes its compiled
+-- plan at the DB level (the service-level soft delete reconciles compiled
+-- rows away explicitly before that ever matters). NOT VALID mirrors the 0041
+-- precedent: no scan on deploy; every new write is checked.
+--
+-- 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 "automations" ADD COLUMN IF NOT EXISTS "managed_by_agent_id" uuid;
+--> statement-breakpoint
+DO $$
+BEGIN
+    IF NOT EXISTS (
+        SELECT 1 FROM pg_constraint
+        WHERE conname = 'automations_managed_by_agent_fk' AND conrelid = '"automations"'::regclass
+    ) THEN
+        ALTER TABLE "automations" ADD CONSTRAINT "automations_managed_by_agent_fk" FOREIGN KEY ("managed_by_agent_id") REFERENCES "agents" ("id") ON DELETE CASCADE NOT VALID;
+    END IF;
+END $$;
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS "automations_managed_by_agent_idx" ON "automations" ("managed_by_agent_id");

package/db/drizzle/meta/_journal.json

@@ -442,6 +442,13 @@
       "when": 1786200000000,
       "tag": "0062_agent_event_manifest",
       "breakpoints": true
+    },
+    {
+      "idx": 63,
+      "version": "7",
+      "when": 1786300000000,
+      "tag": "0063_automation_manifest_provenance",
+      "breakpoints": true
     }
   ]
 }

package/dist/commands/agents.d.ts

@@ -29,6 +29,7 @@ declare function parseManifestSource(source: string, format: 'json' | 'yaml'): u
 declare function validateManifestDocument(raw: unknown): AgentEventManifest;
 /** Minimal agent shape the graph helpers need (matches SDK list output). */
 interface GraphAgentInput {
+    id: string;
     name: string;
     eventManifest?: {
         accepts?: {
@@ -44,12 +45,33 @@ interface GraphRow {
     agent: string;
     consumes: string;
     produces: string;
+    compiled: string;
 }
+/**
+ * Count compiled (manifest-managed) automations per owning agent (#986).
+ * Input is the SDK automations list; rows without `managedByAgentId` are
+ * hand-made and ignored.
+ */
+declare function countManagedAutomations(automations: Array<{
+    managedByAgentId?: string | null;
+}>): Map<string, number>;
+/**
+ * Render the declared-vs-materialized indicator for one agent:
+ *   - `-` when nothing is declared (nothing to compile),
+ *   - `unknown` when the automations list was unavailable,
+ *   - `materialized/declared` otherwise (e.g. `2/2`; `0/2` = declared but
+ *     not yet compiled — the manifest predates the G4b compiler).
+ */
+declare function formatCompiledIndicator(declared: number, materialized: number | undefined): string;
 /**
  * Build the producer/consumer table: one row per agent that declares at least
  * one accepts/publishes entry. Agents without a manifest are omitted.
+ *
+ * `managedCounts` (from `countManagedAutomations`, #986) drives the
+ * `compiled` column — declared vs materialized state; pass undefined when the
+ * automations list could not be fetched.
  */
-declare function buildGraphRows(agents: GraphAgentInput[]): GraphRow[];
+declare function buildGraphRows(agents: GraphAgentInput[], managedCounts?: Map<string, number>): GraphRow[];
 interface TypeGraphRow {
     agent: string;
     role: 'consumes' | 'produces';
@@ -67,6 +89,8 @@ export declare const __testables: {
     validateManifestDocument: typeof validateManifestDocument;
     buildGraphRows: typeof buildGraphRows;
     buildTypeRows: typeof buildTypeRows;
+    countManagedAutomations: typeof countManagedAutomations;
+    formatCompiledIndicator: typeof formatCompiledIndicator;
 };
 export declare function createAgentsCommand(): Command;
 export {};

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

@@ -1 +1 @@
-{"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"}
+{"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,EAAE,EAAE,MAAM,CAAC;IACX,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;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,iBAAS,uBAAuB,CAAC,WAAW,EAAE,KAAK,CAAC;IAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAQ9G;AAED;;;;;;GAMG;AACH,iBAAS,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAI3F;AAQD;;;;;;;GAOG;AACH,iBAAS,cAAc,CAAC,MAAM,EAAE,eAAe,EAAE,EAAE,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,QAAQ,EAAE,CAelG;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;;;;;;;;CAQvB,CAAC;AAEF,wBAAgB,mBAAmB,IAAI,OAAO,CAoR7C"}

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;AA0FpC,wBAAgB,wBAAwB,IAAI,OAAO,CAwUlD"}
+{"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,CA2UlD"}

package/dist/index.js

@@ -82709,6 +82709,7 @@ var init_schema2 = __esm(() => {
     enabled: boolean2("enabled").notNull().default(true),
     priority: integer("priority").notNull().default(0),
     transactionalEmissions: boolean2("transactional_emissions").notNull().default(false),
+    managedByAgentId: uuid("managed_by_agent_id").references(() => agents.id, { onDelete: "cascade" }),
     createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
     updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow(),
     tenantId: uuid("tenant_id").references(() => tenants.id, { onDelete: "restrict" })
@@ -82718,7 +82719,8 @@ var init_schema2 = __esm(() => {
     nameIdx: index("automations_name_idx").on(table3.name),
     triggerIdx: index("automations_trigger_idx").on(table3.triggerEventType),
     enabledIdx: index("automations_enabled_idx").on(table3.enabled),
-    priorityIdx: index("automations_priority_idx").on(table3.priority)
+    priorityIdx: index("automations_priority_idx").on(table3.priority),
+    managedByAgentIdx: index("automations_managed_by_agent_idx").on(table3.managedByAgentId)
   }));
   automationLogStatuses = ["success", "failed", "skipped"];
   automationLogs = pgTable("automation_logs", {
@@ -136693,7 +136695,7 @@ import { fileURLToPath } from "url";
 // package.json
 var package_default = {
   name: "@automagik/omni",
-  version: "2.260908.8",
+  version: "2.260908.9",
   repository: {
     type: "git",
     url: "git+https://github.com/automagik-dev/omni.git",
@@ -137808,11 +137810,28 @@ ${issues}`);
   }
   return result.data;
 }
+function countManagedAutomations(automations2) {
+  const counts = new Map;
+  for (const automation of automations2) {
+    const agentId = automation.managedByAgentId;
+    if (!agentId)
+      continue;
+    counts.set(agentId, (counts.get(agentId) ?? 0) + 1);
+  }
+  return counts;
+}
+function formatCompiledIndicator(declared, materialized) {
+  if (declared === 0)
+    return "-";
+  if (materialized === undefined)
+    return "unknown";
+  return `${materialized}/${declared}`;
+}
 function formatAcceptsEntry(entry) {
   const filtered = entry.filter !== undefined && Object.keys(entry.filter).length > 0;
   return filtered ? `${entry.event} (filtered)` : entry.event;
 }
-function buildGraphRows(agents) {
+function buildGraphRows(agents, managedCounts) {
   const rows = [];
   for (const agent3 of agents) {
     const manifest = agent3.eventManifest;
@@ -137823,7 +137842,8 @@ function buildGraphRows(agents) {
     rows.push({
       agent: agent3.name,
       consumes: accepts.length > 0 ? accepts.map(formatAcceptsEntry).join(", ") : "-",
-      produces: publishes.length > 0 ? publishes.map((entry) => entry.event).join(", ") : "-"
+      produces: publishes.length > 0 ? publishes.map((entry) => entry.event).join(", ") : "-",
+      compiled: formatCompiledIndicator(accepts.length, managedCounts ? managedCounts.get(agent3.id) ?? 0 : undefined)
     });
   }
   return rows;
@@ -137991,7 +138011,13 @@ function createAgentsCommand() {
         list(rows2, { emptyMessage: `No agent declares ${options.type}.` });
         return;
       }
-      const rows = buildGraphRows(items);
+      let managedCounts;
+      try {
+        managedCounts = countManagedAutomations(await client.automations.list({}));
+      } catch {
+        managedCounts = undefined;
+      }
+      const rows = buildGraphRows(items, managedCounts);
       list(rows, { emptyMessage: "No agent declares an event manifest." });
     } catch (err2) {
       const message2 = err2 instanceof Error ? err2.message : "Unknown error";
@@ -138829,7 +138855,8 @@ function createAutomationsCommand() {
         name: a2.name,
         trigger: a2.triggerEventType,
         enabled: a2.enabled ? "yes" : "no",
-        priority: a2.priority
+        priority: a2.priority,
+        managed: a2.managedByAgentId ? "manifest" : "-"
       }));
       list(items, { emptyMessage: "No automations found." });
     } catch (err2) {

package/dist/sdk/types.generated.d.ts

@@ -5596,6 +5596,11 @@ export interface components {
             priority: number;
             /** @description Transactional publication (G5, #988): buffer the run's emit_event publishes and flush them in order only when every action succeeded; a failed run publishes zero */
             transactionalEmissions: boolean;
+            /**
+             * Format: uuid
+             * @description Set when this automation was compiled from an agent event manifest (RFC #925 G4b, #986); null = hand-made. Managed automations reject manual mutation — edit the owning agent’s manifest instead
+             */
+            managedByAgentId: string | null;
             /**
              * Format: date-time
              * @description Creation timestamp
@@ -17032,6 +17037,11 @@ export interface operations {
                             priority: number;
                             /** @description Transactional publication (G5, #988): buffer the run's emit_event publishes and flush them in order only when every action succeeded; a failed run publishes zero */
                             transactionalEmissions: boolean;
+                            /**
+                             * Format: uuid
+                             * @description Set when this automation was compiled from an agent event manifest (RFC #925 G4b, #986); null = hand-made. Managed automations reject manual mutation — edit the owning agent’s manifest instead
+                             */
+                            managedByAgentId: string | null;
                             /**
                              * Format: date-time
                              * @description Creation timestamp
@@ -17315,6 +17325,11 @@ export interface operations {
                             priority: number;
                             /** @description Transactional publication (G5, #988): buffer the run's emit_event publishes and flush them in order only when every action succeeded; a failed run publishes zero */
                             transactionalEmissions: boolean;
+                            /**
+                             * Format: uuid
+                             * @description Set when this automation was compiled from an agent event manifest (RFC #925 G4b, #986); null = hand-made. Managed automations reject manual mutation — edit the owning agent’s manifest instead
+                             */
+                            managedByAgentId: string | null;
                             /**
                              * Format: date-time
                              * @description Creation timestamp
@@ -17491,6 +17506,11 @@ export interface operations {
                             priority: number;
                             /** @description Transactional publication (G5, #988): buffer the run's emit_event publishes and flush them in order only when every action succeeded; a failed run publishes zero */
                             transactionalEmissions: boolean;
+                            /**
+                             * Format: uuid
+                             * @description Set when this automation was compiled from an agent event manifest (RFC #925 G4b, #986); null = hand-made. Managed automations reject manual mutation — edit the owning agent’s manifest instead
+                             */
+                            managedByAgentId: string | null;
                             /**
                              * Format: date-time
                              * @description Creation timestamp
@@ -17845,6 +17865,11 @@ export interface operations {
                             priority: number;
                             /** @description Transactional publication (G5, #988): buffer the run's emit_event publishes and flush them in order only when every action succeeded; a failed run publishes zero */
                             transactionalEmissions: boolean;
+                            /**
+                             * Format: uuid
+                             * @description Set when this automation was compiled from an agent event manifest (RFC #925 G4b, #986); null = hand-made. Managed automations reject manual mutation — edit the owning agent’s manifest instead
+                             */
+                            managedByAgentId: string | null;
                             /**
                              * Format: date-time
                              * @description Creation timestamp
@@ -18021,6 +18046,11 @@ export interface operations {
                             priority: number;
                             /** @description Transactional publication (G5, #988): buffer the run's emit_event publishes and flush them in order only when every action succeeded; a failed run publishes zero */
                             transactionalEmissions: boolean;
+                            /**
+                             * Format: uuid
+                             * @description Set when this automation was compiled from an agent event manifest (RFC #925 G4b, #986); null = hand-made. Managed automations reject manual mutation — edit the owning agent’s manifest instead
+                             */
+                            managedByAgentId: string | null;
                             /**
                              * Format: date-time
                              * @description Creation timestamp
@@ -18197,6 +18227,11 @@ export interface operations {
                             priority: number;
                             /** @description Transactional publication (G5, #988): buffer the run's emit_event publishes and flush them in order only when every action succeeded; a failed run publishes zero */
                             transactionalEmissions: boolean;
+                            /**
+                             * Format: uuid
+                             * @description Set when this automation was compiled from an agent event manifest (RFC #925 G4b, #986); null = hand-made. Managed automations reject manual mutation — edit the owning agent’s manifest instead
+                             */
+                            managedByAgentId: string | null;
                             /**
                              * Format: date-time
                              * @description Creation timestamp