@automagik/omni 2.260910.8 → 2.260910.10

package/dist/index.js

@@ -40197,6 +40197,12 @@ function resolveTemplatePath(path, context) {
   const specialValue = resolveSpecialValue(trimmed, root, rest, context);
   if (specialValue !== undefined)
     return specialValue;
+  if (trimmed === "payload_json")
+    return JSON.stringify(context.payload);
+  if (trimmed === "event_json") {
+    const { id = null, type = null, timestamp = null, metadata = null } = context.event ?? {};
+    return JSON.stringify({ id, type, timestamp, metadata, payload: context.payload });
+  }
   if (root === "payload")
     return rest ? getNestedValue(context.payload, rest) : context.payload;
   if (root === "env")
@@ -74699,7 +74705,7 @@ __export(exports_embedded_canonical_migration, {
   EMBEDDED_PGSERVE_DATA_DIR: () => EMBEDDED_PGSERVE_DATA_DIR
 });
 import { execFileSync as execFileSync3, spawn, spawnSync as spawnSync2 } from "child_process";
-import { existsSync as existsSync10, mkdirSync as mkdirSync7, mkdtempSync, readFileSync as readFileSync8, readdirSync as readdirSync3, symlinkSync as symlinkSync2 } from "fs";
+import { existsSync as existsSync10, mkdirSync as mkdirSync7, mkdtempSync, readFileSync as readFileSync9, readdirSync as readdirSync3, symlinkSync as symlinkSync2 } from "fs";
 import { createServer } from "net";
 import { arch, homedir as homedir8, platform, tmpdir } from "os";
 import { dirname as dirname2, join as join12 } from "path";
@@ -74725,7 +74731,7 @@ function defaultLog(line) {
 }
 function readDataDirMajor(dataDir) {
   try {
-    const major = Number.parseInt(readFileSync8(join12(dataDir, "PG_VERSION"), "utf8").trim(), 10);
+    const major = Number.parseInt(readFileSync9(join12(dataDir, "PG_VERSION"), "utf8").trim(), 10);
     return Number.isFinite(major) ? major : null;
   } catch {
     return null;
@@ -74800,7 +74806,7 @@ function materializeReaderLibs(nativeDir) {
   const libDir = join12(nativeDir, "lib");
   try {
     const pkgRoot = dirname2(nativeDir);
-    const pairs = JSON.parse(readFileSync8(join12(nativeDir, "pg-symlinks.json"), "utf8"));
+    const pairs = JSON.parse(readFileSync9(join12(nativeDir, "pg-symlinks.json"), "utf8"));
     for (const { source, target } of pairs) {
       const tgt = join12(pkgRoot, target);
       if (!existsSync10(tgt)) {
@@ -84148,13 +84154,13 @@ var init_postgres_js = __esm(() => {
 });
 
 // ../db/src/client.ts
-import { readFileSync as readFileSync13 } from "fs";
+import { readFileSync as readFileSync14 } from "fs";
 function resolveSslConfig(caFile, env2 = process.env) {
   const path = caFile || env2.DATABASE_SSL_CA_FILE;
   if (!path) {
     return;
   }
-  return { ca: readFileSync13(path, "utf8"), rejectUnauthorized: true };
+  return { ca: readFileSync14(path, "utf8"), rejectUnauthorized: true };
 }
 function getDefaultDatabaseUrl() {
   const url = process.env.DATABASE_URL;
@@ -115758,7 +115764,7 @@ var require_client2 = __commonJS((exports) => {
 
 // ../../node_modules/.bun/@sentry+node-core@10.52.0+2c50d7e904f6cfd7/node_modules/@sentry/node-core/build/cjs/sdk/esmLoader.js
 var require_esmLoader = __commonJS((exports) => {
-  var __filename = "/home/runner/work/omni/omni/node_modules/.bun/@sentry+node-core@10.52.0+2c50d7e904f6cfd7/node_modules/@sentry/node-core/build/cjs/sdk/esmLoader.js";
+  var __filename = "/home/runner/work/omni/omni/.stable-source/node_modules/.bun/@sentry+node-core@10.52.0+2c50d7e904f6cfd7/node_modules/@sentry/node-core/build/cjs/sdk/esmLoader.js";
   Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
   var core = require_cjs();
   var importInTheMiddle = require_import_in_the_middle();
@@ -137182,7 +137188,7 @@ import { fileURLToPath } from "url";
 // package.json
 var package_default = {
   name: "@automagik/omni",
-  version: "2.260910.8",
+  version: "2.260910.10",
   repository: {
     type: "git",
     url: "git+https://github.com/automagik-dev/omni.git",
@@ -139281,51 +139287,108 @@ one, or the entry named by the global flag:
 }
 
 // src/commands/automations.ts
+import { readFileSync as readFileSync7 } from "fs";
 init_output();
+function collectRepeated(value, previous) {
+  return [...previous ?? [], value];
+}
 function parseJson(json, fieldName) {
   try {
-    return { ok: true, value: JSON.parse(json) };
+    return JSON.parse(json);
   } catch {
-    return { ok: false, error: `Invalid JSON for ${fieldName}` };
+    throw new Error(`Invalid JSON for ${fieldName}`);
   }
 }
-function buildActionConfig(options) {
-  let config2 = {};
-  if (options.actionConfig) {
-    const result = parseJson(options.actionConfig, "--action-config");
-    if (!result.ok)
-      return result;
-    config2 = result.value;
-  }
-  if (options.action === "call_agent") {
-    if (options.agentId)
-      config2.agentId = options.agentId;
-    if (options.providerId)
-      config2.providerId = options.providerId;
-    if (options.responseAs)
-      config2.responseAs = options.responseAs;
-    if (!config2.agentId) {
-      return { ok: false, error: "call_agent action requires --agent-id or agentId in --action-config" };
-    }
-  }
-  return { ok: true, config: config2 };
-}
-function parseConditions(options) {
-  let conditions2;
-  let logic;
-  if (options.condition) {
-    const result = parseJson(options.condition, "--condition");
-    if (!result.ok)
-      return result;
-    conditions2 = result.value;
+function readDefinitionFile(path) {
+  let text;
+  try {
+    text = readFileSync7(path, "utf-8");
+  } catch (err2) {
+    const reason = err2 instanceof Error ? err2.message : "Unknown error";
+    throw new Error(`Cannot read --file '${path}': ${reason}`);
   }
-  if (options.conditionLogic) {
-    if (options.conditionLogic !== "and" && options.conditionLogic !== "or") {
-      return { ok: false, error: '--condition-logic must be "and" or "or"' };
-    }
-    logic = options.conditionLogic;
+  const parsed = parseJson(text, "--file");
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error("--file must contain a JSON object");
   }
-  return { ok: true, conditions: conditions2, logic };
+  const readOnly = new Set(["id", "createdAt", "updatedAt", "managedByAgentId"]);
+  const body = Object.fromEntries(Object.entries(parsed).filter(([key, value]) => !readOnly.has(key) && value !== null));
+  return body;
+}
+function applyCallAgentShortcuts(config2, options) {
+  if (options.agentId)
+    config2.agentId = options.agentId;
+  if (options.providerId)
+    config2.providerId = options.providerId;
+  if (options.responseAs)
+    config2.responseAs = options.responseAs;
+}
+function buildActions(options) {
+  const types8 = options.action ?? [];
+  const configs = options.actionConfig ?? [];
+  if (types8.length === 0) {
+    if (configs.length > 0)
+      throw new Error("--action-config requires a matching --action");
+    return;
+  }
+  if (configs.length > types8.length) {
+    throw new Error(`Got ${configs.length} --action-config for ${types8.length} --action`);
+  }
+  const firstCallAgent = types8.indexOf("call_agent");
+  return types8.map((type, i6) => {
+    const raw2 = configs[i6];
+    const config2 = raw2 ? parseJson(raw2, `--action-config #${i6 + 1}`) : {};
+    if (type === "call_agent") {
+      if (i6 === firstCallAgent)
+        applyCallAgentShortcuts(config2, options);
+      if (!config2.agentId) {
+        throw new Error("call_agent action requires --agent-id or agentId in --action-config");
+      }
+    }
+    return { type, config: config2 };
+  });
+}
+function parseConditionLogic(logic) {
+  if (logic === undefined)
+    return;
+  if (logic !== "and" && logic !== "or")
+    throw new Error('--condition-logic must be "and" or "or"');
+  return logic;
+}
+function buildDefinition(options) {
+  const body = options.file ? readDefinitionFile(options.file) : {};
+  const actions2 = buildActions(options);
+  if (actions2)
+    body.actions = actions2;
+  if (options.name !== undefined)
+    body.name = options.name;
+  if (options.description !== undefined)
+    body.description = options.description;
+  if (options.trigger !== undefined)
+    body.triggerEventType = options.trigger;
+  if (options.condition !== undefined)
+    body.triggerConditions = parseJson(options.condition, "--condition");
+  const logic = parseConditionLogic(options.conditionLogic);
+  if (logic !== undefined)
+    body.conditionLogic = logic;
+  if (options.priority !== undefined)
+    body.priority = options.priority;
+  if (options.transactionalEmissions !== undefined)
+    body.transactionalEmissions = options.transactionalEmissions;
+  return body;
+}
+function buildCreateBody(options) {
+  const body = buildDefinition(options);
+  if (!body.name)
+    throw new Error('--name is required (or "name" in --file)');
+  if (!body.triggerEventType)
+    throw new Error('--trigger is required (or "triggerEventType" in --file)');
+  if (!body.actions || body.actions.length === 0) {
+    throw new Error('At least one --action is required (or "actions" in --file)');
+  }
+  if (options.disabled)
+    body.enabled = false;
+  return body;
 }
 function createAutomationsCommand() {
   const automations2 = new Command("automations").description("Manage automations");
@@ -139363,39 +139426,15 @@ function createAutomationsCommand() {
       error(`Failed to get automation: ${message2}`);
     }
   });
-  automations2.command("create").description("Create an automation").requiredOption("--name <name>", "Automation name").requiredOption("--trigger <event>", "Trigger event type (e.g., message.received)").requiredOption("--action <type>", "Action type (webhook, send_message, emit_event, log, call_agent)").option("--action-config <json>", "Action config as JSON").option("--condition <json>", "Trigger conditions as JSON array").option("--condition-logic <logic>", 'Condition logic: "and" (all must match) or "or" (any must match)').option("--description <desc>", "Automation description").option("--priority <n>", "Priority (higher = runs first)", (v4) => Number.parseInt(v4, 10)).option("--disabled", "Create in disabled state").option("--transactional-emissions", "Buffer the run's emit_event publishes and flush them in order only when every action succeeded; " + "a failed run publishes zero (#988). Defaults to off (immediate publishing)").option("--agent-id <id>", "Agent ID (for call_agent action)").option("--provider-id <id>", "Provider ID (for call_agent action)").option("--response-as <var>", "Store agent response as variable (for call_agent action)").action(async (options) => {
+  automations2.command("create").description("Create an automation").option("--file <path>", "Full definition as JSON (the `get` output works as-is); explicit flags override it").option("--name <name>", "Automation name").option("--trigger <event>", "Trigger event type (e.g., message.received)").option("--action <type>", "Action type (webhook, send_message, emit_event, log, call_agent); repeat for ordered multi-action", collectRepeated).option("--action-config <json>", "Action config as JSON; the i-th pairs with the i-th --action", collectRepeated).option("--condition <json>", "Trigger conditions as JSON array").option("--condition-logic <logic>", 'Condition logic: "and" (all must match) or "or" (any must match)').option("--description <desc>", "Automation description").option("--priority <n>", "Priority (higher = runs first)", (v4) => Number.parseInt(v4, 10)).option("--disabled", "Create in disabled state").option("--transactional-emissions", "Buffer the run's emit_event publishes and flush them in order only when every action succeeded; " + "a failed run publishes zero (#988). Defaults to off (immediate publishing)").option("--agent-id <id>", "Agent ID (for the first call_agent action)").option("--provider-id <id>", "Provider ID (for the first call_agent action)").option("--response-as <var>", "Store agent response as variable (for the first call_agent action)").action(async (options) => {
     const client = getClient();
     try {
-      const actionResult = buildActionConfig(options);
-      if (!actionResult.ok) {
-        error(actionResult.error);
-        return;
-      }
-      const conditionResult = parseConditions(options);
-      if (!conditionResult.ok) {
-        error(conditionResult.error);
-        return;
-      }
-      const automation = await client.automations.create({
-        name: options.name,
-        description: options.description,
-        triggerEventType: options.trigger,
-        triggerConditions: conditionResult.conditions,
-        conditionLogic: conditionResult.logic,
-        actions: [
-          {
-            type: options.action,
-            config: actionResult.config
-          }
-        ],
-        priority: options.priority,
-        enabled: !options.disabled,
-        transactionalEmissions: options.transactionalEmissions
-      });
+      const automation = await client.automations.create(buildCreateBody(options));
       success(`Automation created: ${automation.id}`, {
         id: automation.id,
         name: automation.name,
         trigger: automation.triggerEventType,
+        actions: automation.actions.length,
         enabled: automation.enabled
       });
     } catch (err2) {
@@ -139403,19 +139442,21 @@ function createAutomationsCommand() {
       error(`Failed to create automation: ${message2}`);
     }
   });
-  automations2.command("update <id>").description("Update an automation").option("--name <name>", "New name").option("--description <desc>", "New description").option("--priority <n>", "New priority", (v4) => Number.parseInt(v4, 10)).option("--transactional-emissions", "Buffer the run's emit_event publishes and flush them in order only when every action succeeded; " + "a failed run publishes zero (#988)").option("--no-transactional-emissions", "Return the automation to immediate mid-sequence publishing").action(async (id, options) => {
+  automations2.command("update <id>").description("Update an automation in place (id and execution logs are kept)").option("--file <path>", "Full definition as JSON (the `get` output works as-is); explicit flags override it").option("--name <name>", "New name").option("--description <desc>", "New description").option("--trigger <event>", "New trigger event type").option("--condition <json>", "Replace trigger conditions (JSON array)").option("--condition-logic <logic>", 'Condition logic: "and" or "or"').option("--action <type>", "Replace the actions list; repeat for ordered multi-action", collectRepeated).option("--action-config <json>", "Action config as JSON; the i-th pairs with the i-th --action", collectRepeated).option("--priority <n>", "New priority", (v4) => Number.parseInt(v4, 10)).option("--transactional-emissions", "Buffer the run's emit_event publishes and flush them in order only when every action succeeded; " + "a failed run publishes zero (#988)").option("--no-transactional-emissions", "Return the automation to immediate mid-sequence publishing").option("--agent-id <id>", "Agent ID (for the first call_agent action)").option("--provider-id <id>", "Provider ID (for the first call_agent action)").option("--response-as <var>", "Store agent response as variable (for the first call_agent action)").action(async (id, options) => {
     const client = getClient();
     try {
+      const body = buildDefinition(options);
+      if (Object.keys(body).length === 0) {
+        error("Nothing to update: pass at least one field flag or --file");
+        return;
+      }
       const automationId = await resolveAutomationId(id);
-      const automation = await client.automations.update(automationId, {
-        name: options.name,
-        description: options.description,
-        priority: options.priority,
-        transactionalEmissions: options.transactionalEmissions
-      });
+      const automation = await client.automations.update(automationId, body);
       success(`Automation updated: ${automation.id}`, {
         id: automation.id,
-        name: automation.name
+        name: automation.name,
+        trigger: automation.triggerEventType,
+        actions: automation.actions.length
       });
     } catch (err2) {
       const message2 = err2 instanceof Error ? err2.message : "Unknown error";
@@ -142475,7 +142516,7 @@ init_src2();
 init_config();
 init_output();
 import { spawnSync } from "child_process";
-import { existsSync as existsSync9, mkdirSync as mkdirSync6, readFileSync as readFileSync7, renameSync as renameSync2, statSync as statSync2, writeFileSync as writeFileSync6 } from "fs";
+import { existsSync as existsSync9, mkdirSync as mkdirSync6, readFileSync as readFileSync8, renameSync as renameSync2, statSync as statSync2, writeFileSync as writeFileSync6 } from "fs";
 import { homedir as homedir7 } from "os";
 import { join as join11 } from "path";
 import { gunzipSync as gunzipSync2, gzipSync as gzipSync2 } from "zlib";
@@ -142668,7 +142709,7 @@ function getEmbeddedPgserveDataDir() {
 }
 function embeddedServerMajor() {
   try {
-    const v4 = Number.parseInt(readFileSync7(join11(getEmbeddedPgserveDataDir(), "PG_VERSION"), "utf8").trim(), 10);
+    const v4 = Number.parseInt(readFileSync8(join11(getEmbeddedPgserveDataDir(), "PG_VERSION"), "utf8").trim(), 10);
     return Number.isFinite(v4) ? v4 : null;
   } catch {
     return null;
@@ -142683,7 +142724,7 @@ function getCanonicalPgserveDataDir() {
   if (!existsSync9(PGSERVE_CONFIG_PATH))
     return PGSERVE_DEFAULT_DATA_DIR;
   try {
-    const raw2 = readFileSync7(PGSERVE_CONFIG_PATH, "utf8");
+    const raw2 = readFileSync8(PGSERVE_CONFIG_PATH, "utf8");
     const parsed = JSON.parse(raw2);
     return typeof parsed.dataDir === "string" && parsed.dataDir.length > 0 ? parsed.dataDir : PGSERVE_DEFAULT_DATA_DIR;
   } catch {
@@ -142765,7 +142806,7 @@ async function restoreSnapshotToCanonical(dump, canonicalDatabaseUrl) {
   raw(`    snapshot:           ${dump.snapshotPath}`);
   raw(`    canonical data dir: ${getCanonicalPgserveDataDir()}`);
   raw(`    canonical URL:      ${canonicalDatabaseUrl}`);
-  const compressed = readFileSync7(dump.snapshotPath);
+  const compressed = readFileSync8(dump.snapshotPath);
   const sql = gunzipSync2(compressed);
   const result = spawnSync("psql", ["-v", "ON_ERROR_STOP=1"], {
     env: { ...process.env, ...pgEnvFromUrl(canonicalDatabaseUrl) },
@@ -143673,7 +143714,7 @@ Safety:
 }
 
 // src/commands/done.ts
-import { existsSync as existsSync12, readFileSync as readFileSync9 } from "fs";
+import { existsSync as existsSync12, readFileSync as readFileSync10 } from "fs";
 import { basename, extname } from "path";
 
 // src/context.ts
@@ -143787,7 +143828,7 @@ async function handleMedia(client, ctx, mediaPath, caption) {
   }
   try {
     const mediaType = getMediaType(mediaPath);
-    const buffer3 = readFileSync9(mediaPath);
+    const buffer3 = readFileSync10(mediaPath);
     const base64 = buffer3.toString("base64");
     const filename = basename(mediaPath);
     await client.messages.sendMedia({
@@ -143846,7 +143887,7 @@ function createDoneCommand() {
 
 // src/commands/events.ts
 init_src();
-import { readFileSync as readFileSync10 } from "fs";
+import { readFileSync as readFileSync11 } from "fs";
 init_zod();
 init_config();
 init_output();
@@ -144034,13 +144075,19 @@ function loadSchemaArtifact(options) {
   if ((options.file ? 1 : 0) + (options.schema ? 1 : 0) !== 1) {
     throw new Error("Provide the JSON Schema via exactly one of --file <path> or --schema <json>");
   }
-  const raw2 = options.file ? readFileSync10(options.file, "utf-8") : options.schema;
+  const raw2 = options.file ? readFileSync11(options.file, "utf-8") : options.schema;
   const parsed = JSON.parse(raw2);
   if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
     throw new Error("The JSON Schema artifact must be a JSON object");
   }
   return parsed;
 }
+function loadPayload(options) {
+  if ((options.file ? 1 : 0) + (options.payload ? 1 : 0) !== 1) {
+    throw new Error("Provide the payload via exactly one of --file <path> or --payload <json>");
+  }
+  return JSON.parse(options.file ? readFileSync11(options.file, "utf-8") : options.payload);
+}
 function summarizeSchemaRow(row) {
   return {
     eventType: row.eventType,
@@ -144093,6 +144140,29 @@ function createSchemaCommand() {
       error(`Failed to get schema: ${message2}`);
     }
   });
+  schema.command("validate <eventType>").description("Validate a payload against the registered schema without emitting an event (exit 1 on violations)").option("--file <path>", "Path to a JSON payload file").option("--payload <json>", "Inline JSON payload").action(async (eventType, options) => {
+    let result;
+    try {
+      const payload = loadPayload(options);
+      const res = await schemaApiRequest(`/${encodeURIComponent(eventType)}/validate`, {
+        method: "POST",
+        body: JSON.stringify({ payload })
+      });
+      result = res.data;
+    } catch (err2) {
+      const message2 = err2 instanceof Error ? err2.message : "Unknown error";
+      error(`Failed to validate payload: ${message2}`, undefined, 2);
+    }
+    if (result.valid) {
+      success(`Payload is valid for ${result.eventType} (schema version ${result.version})`, result);
+      return;
+    }
+    if (getCurrentFormat() === "human") {
+      for (const line of result.errors)
+        raw(`  - ${line}`);
+    }
+    error(`Payload violates the schema for ${result.eventType} (schema version ${result.version}): ${result.errors.length} issue(s)`, getCurrentFormat() === "json" ? result : undefined);
+  });
   return schema;
 }
 function eventListRow(e10) {
@@ -144626,7 +144696,7 @@ function createEventsCommand() {
 }
 
 // src/commands/film.ts
-import { readFileSync as readFileSync11, writeFileSync as writeFileSync7 } from "fs";
+import { readFileSync as readFileSync12, writeFileSync as writeFileSync7 } from "fs";
 import { resolve as resolvePath } from "path";
 init_output();
 function createFilmCommand() {
@@ -144670,7 +144740,7 @@ function createFilmCommand() {
     let imageMimeType;
     if (options.reference) {
       try {
-        const ref = readFileSync11(resolvePath(options.reference));
+        const ref = readFileSync12(resolvePath(options.reference));
         imageBase64 = ref.toString("base64");
         imageMimeType = mimeForImagePath(options.reference);
       } catch (err2) {
@@ -144742,7 +144812,7 @@ function mimeForImagePath(path) {
 }
 
 // src/commands/follow-up.ts
-import { readFileSync as readFileSync12 } from "fs";
+import { readFileSync as readFileSync13 } from "fs";
 init_output();
 var VALID_SCOPES = ["agents", "instances", "chats"];
 function assertScope(scope) {
@@ -144760,9 +144830,9 @@ async function resolveScopedId(scope, id) {
 function readJsonArg(raw2) {
   let body = raw2;
   if (body === "-") {
-    body = readFileSync12(0, "utf8");
+    body = readFileSync13(0, "utf8");
   } else if (body.startsWith("@")) {
-    body = readFileSync12(body.slice(1), "utf8");
+    body = readFileSync13(body.slice(1), "utf8");
   }
   try {
     return JSON.parse(body);
@@ -146476,7 +146546,7 @@ function formatKeyRow(key) {
 function parseCommaSeparated(value) {
   return value.split(",").map((s2) => s2.trim()).filter(Boolean);
 }
-function collectRepeated(value, previous) {
+function collectRepeated2(value, previous) {
   return [...previous ?? [], value];
 }
 async function readLineFromStdin() {
@@ -146695,7 +146765,7 @@ async function handleDelete(client, id) {
 }
 function createKeysCommand() {
   const keys = new Command("keys").description("Manage API keys");
-  keys.command("create").description("Create a new API key (optionally from a profile template)").requiredOption("--name <name>", "Key name").option("--profile <name>", "Profile template: cs | personal | scout | coworker | admin").option("--scopes <scopes>", "Comma-separated scopes (legacy \u2014 omit when --profile is set; scopes derive from the profile)").option("--lock-chat <jid>", "Lock this key to a chat (repeat for multiple)", collectRepeated).option("--lock-instance <id>", "Lock this key to an instance (repeat for multiple)", collectRepeated).option("--owner <jid>", "Scout: owner JID \u2014 populates outboundRecipientAllowlist").option("--denylist-preset <key>", "Coworker: denylist preset key (overrides profile default)").option("--instances <ids>", "Comma-separated instance IDs to restrict access (legacy)").option("--description <desc>", "Key description").option("--rate-limit <n>", "Rate limit (requests/minute)", Number.parseInt).option("--expires <date>", "Expiration date (ISO 8601)").action(async (options) => {
+  keys.command("create").description("Create a new API key (optionally from a profile template)").requiredOption("--name <name>", "Key name").option("--profile <name>", "Profile template: cs | personal | scout | coworker | admin").option("--scopes <scopes>", "Comma-separated scopes (legacy \u2014 omit when --profile is set; scopes derive from the profile)").option("--lock-chat <jid>", "Lock this key to a chat (repeat for multiple)", collectRepeated2).option("--lock-instance <id>", "Lock this key to an instance (repeat for multiple)", collectRepeated2).option("--owner <jid>", "Scout: owner JID \u2014 populates outboundRecipientAllowlist").option("--denylist-preset <key>", "Coworker: denylist preset key (overrides profile default)").option("--instances <ids>", "Comma-separated instance IDs to restrict access (legacy)").option("--description <desc>", "Key description").option("--rate-limit <n>", "Rate limit (requests/minute)", Number.parseInt).option("--expires <date>", "Expiration date (ISO 8601)").action(async (options) => {
     const needsClient = options.profile !== "admin";
     const client = needsClient ? getClient() : null;
     try {
@@ -148098,7 +148168,7 @@ init_output();
 init_src();
 import { execFileSync as execFileSync4, execSync } from "child_process";
 import * as nodeCrypto2 from "crypto";
-import { existsSync as existsSync15, mkdirSync as mkdirSync10, readFileSync as readFileSync14, writeFileSync as writeFileSync10 } from "fs";
+import { existsSync as existsSync15, mkdirSync as mkdirSync10, readFileSync as readFileSync15, writeFileSync as writeFileSync10 } from "fs";
 import { homedir as homedir11 } from "os";
 import { dirname as dirname6, resolve as resolve3 } from "path";
 import { createInterface as createInterface2 } from "readline";
@@ -148331,7 +148401,7 @@ var PLUGIN_MARKER = "plugin-openclaw/omni.ts";
 function readOpenClawConfig(configPath) {
   if (!existsSync15(configPath))
     return {};
-  const raw2 = readFileSync14(configPath, "utf-8").trim();
+  const raw2 = readFileSync15(configPath, "utf-8").trim();
   if (!raw2)
     return {};
   return JSON.parse(raw2);
@@ -149503,7 +149573,7 @@ function createScheduleCommand() {
 }
 
 // src/commands/see.ts
-import { existsSync as existsSync16, readFileSync as readFileSync15, statSync as statSync5 } from "fs";
+import { existsSync as existsSync16, readFileSync as readFileSync16, statSync as statSync5 } from "fs";
 import { extname as extname4 } from "path";
 init_output();
 var MIME_BY_EXT = {
@@ -149546,7 +149616,7 @@ function loadMedia(file) {
     error(`File is empty: ${file}`);
   }
   try {
-    return { buffer: readFileSync15(file), mimeType: guessMimeType(file) };
+    return { buffer: readFileSync16(file), mimeType: guessMimeType(file) };
   } catch (err2) {
     const message2 = err2 instanceof Error ? err2.message : "Unknown error";
     return error(`Failed to read ${file}: ${message2}`);
@@ -149621,7 +149691,7 @@ function createSeeCommand() {
 }
 
 // src/commands/send.ts
-import { existsSync as existsSync17, readFileSync as readFileSync16 } from "fs";
+import { existsSync as existsSync17, readFileSync as readFileSync17 } from "fs";
 import { basename as basename5, extname as extname5 } from "path";
 init_source();
 init_zod();
@@ -149642,7 +149712,7 @@ function getMediaType2(path) {
   return "document";
 }
 function readFileAsBase64(path) {
-  const buffer3 = readFileSync16(path);
+  const buffer3 = readFileSync17(path);
   return buffer3.toString("base64");
 }
 function parseLoadingMessages(value) {
@@ -151715,7 +151785,7 @@ async function cleanupLegacyArtifacts(skipList) {
 init_output();
 
 // src/update-diagnostics.ts
-import { existsSync as existsSync19, mkdirSync as mkdirSync12, readFileSync as readFileSync17, writeFileSync as writeFileSync11 } from "fs";
+import { existsSync as existsSync19, mkdirSync as mkdirSync12, readFileSync as readFileSync18, writeFileSync as writeFileSync11 } from "fs";
 import { homedir as homedir13 } from "os";
 import { join as join18 } from "path";
 var UPDATE_DIAGNOSTICS_SCHEMA_VERSION = 1;
@@ -151750,7 +151820,7 @@ function tailFileLines(path, maxLines) {
   if (!existsSync19(path))
     return [];
   try {
-    const raw2 = readFileSync17(path, "utf8");
+    const raw2 = readFileSync18(path, "utf8");
     const lines = raw2.split(/\r?\n/);
     if (lines.length > 0 && lines[lines.length - 1] === "")
       lines.pop();
@@ -152434,7 +152504,7 @@ ${lines.join(`
 }
 
 // src/commands/webhooks.ts
-import { readFileSync as readFileSync18 } from "fs";
+import { readFileSync as readFileSync19 } from "fs";
 init_zod();
 init_output();
 var SIGNATURE_ALGORITHMS = ["hmac-sha256", "hmac-sha1", "token-match"];
@@ -152522,7 +152592,7 @@ function resolveEventTypeMapping(raw2) {
   if (raw2.startsWith("@")) {
     const path = raw2.slice(1);
     try {
-      text3 = readFileSync18(path, "utf-8");
+      text3 = readFileSync19(path, "utf-8");
     } catch (err2) {
       const reason = err2 instanceof Error ? err2.message : "Unknown error";
       throw new Error(`Cannot read --event-type-mapping file '${path}': ${reason}`);
@@ -152737,7 +152807,7 @@ function createWebhooksCommand() {
       error(`Failed to delete webhook source: ${message2}`);
     }
   });
-  webhooks.command("trigger").description("Trigger a custom event").requiredOption("--type <type>", "Event type").requiredOption("--payload <json>", "Event payload as JSON").option("--instance <id>", "Instance ID").option("--correlation-id <id>", "Correlation ID").action(async (options3) => {
+  webhooks.command("trigger").description("Trigger a custom event").requiredOption("--type <type>", "Event type").requiredOption("--payload <json>", "Event payload as JSON").option("--instance <id>", "Instance ID").option("--correlation-id <id>", "Correlation ID").option("--causation-id <event-id>", "Parent event ID (keeps the causality tree for mid-flow emissions, #1072)").action(async (options3) => {
     const client = getClient();
     try {
       let payload;
@@ -152751,7 +152821,8 @@ function createWebhooksCommand() {
         eventType: options3.type,
         payload,
         instanceId: options3.instance,
-        correlationId: options3.correlationId
+        correlationId: options3.correlationId,
+        causationId: options3.causationId
       });
       success(`Event triggered: ${result.eventId}`, {
         eventId: result.eventId,
@@ -152808,7 +152879,7 @@ init_config();
 init_output();
 
 // src/manifest-pin.ts
-import { existsSync as existsSync21, readFileSync as readFileSync19, renameSync as renameSync3, writeFileSync as writeFileSync12 } from "fs";
+import { existsSync as existsSync21, readFileSync as readFileSync20, renameSync as renameSync3, writeFileSync as writeFileSync12 } from "fs";
 import { homedir as homedir14 } from "os";
 import { join as join20 } from "path";
 var PACKAGE_NAME2 = "@automagik/omni";
@@ -152818,7 +152889,7 @@ function pinManifestEntry(manifestPath, exactVersion) {
     return false;
   let manifest;
   try {
-    manifest = JSON.parse(readFileSync19(manifestPath, "utf-8"));
+    manifest = JSON.parse(readFileSync20(manifestPath, "utf-8"));
   } catch {
     return false;
   }

package/dist/sdk/client.d.ts

@@ -722,6 +722,8 @@ export interface TriggerEventBody {
     eventType: string;
     payload: Record<string, unknown>;
     correlationId?: string;
+    /** Parent event id — stamps `causationId` so `events trace` parents this emission (#1072). */
+    causationId?: string;
     instanceId?: string;
 }
 /**