@automagik/omni 2.260910.7 → 2.260910.9

package/dist/index.js

@@ -34839,6 +34839,37 @@ var init_agent_task = __esm(() => {
   });
 });
 
+// ../core/src/schemas/agent-usage.ts
+function agentUsageFromResult(metadata) {
+  const cost = metadata.cost;
+  if (!cost)
+    return null;
+  const parsed = AgentUsageSchema.safeParse({
+    providerId: metadata.providerId,
+    runId: metadata.runId,
+    costUsd: cost.costUsd,
+    tokensIn: cost.inputTokens,
+    tokensOut: cost.outputTokens,
+    model: cost.model
+  });
+  if (!parsed.success)
+    return null;
+  const { providerId: _p, runId: _r, ...fields } = parsed.data;
+  return Object.values(fields).some((v) => v !== undefined) ? parsed.data : null;
+}
+var AgentUsageSchema, AGENT_USAGE_METADATA_KEY = "agentUsage";
+var init_agent_usage = __esm(() => {
+  init_zod();
+  AgentUsageSchema = exports_external.object({
+    providerId: exports_external.string(),
+    runId: exports_external.string(),
+    costUsd: exports_external.number().nonnegative().optional(),
+    tokensIn: exports_external.number().int().nonnegative().optional(),
+    tokensOut: exports_external.number().int().nonnegative().optional(),
+    model: exports_external.string().min(1).optional()
+  });
+});
+
 // ../core/src/schemas/conversation.ts
 var ConversationSchema, CreateConversationSchema, UpdateConversationSchema;
 var init_conversation = __esm(() => {
@@ -35711,6 +35742,7 @@ var init_schemas = __esm(() => {
   init_agent_route();
   init_agent_state();
   init_agent_task();
+  init_agent_usage();
   init_common();
   init_conversation();
   init_follow_up();
@@ -40165,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")
@@ -42992,7 +43030,8 @@ class AgnoClient {
       metrics: data2.metrics ? {
         inputTokens: data2.metrics.input_tokens ?? 0,
         outputTokens: data2.metrics.output_tokens ?? 0,
-        durationMs: data2.metrics.duration ?? 0
+        durationMs: data2.metrics.duration ?? 0,
+        model: data2.model
       } : undefined
     };
   }
@@ -66613,6 +66652,12 @@ Please migrate to a newer model. Visit https://docs.anthropic.com/en/docs/resour
 });
 
 // ../core/src/providers/claude-code-client.ts
+function extractModel(msg) {
+  const usage = msg.modelUsage;
+  if (!usage || typeof usage !== "object")
+    return;
+  return Object.keys(usage)[0];
+}
 function getToolPreview(name, input) {
   if (name === "Bash" && input.command)
     return String(input.command).slice(0, 100);
@@ -66825,7 +66870,8 @@ function handleResult2(msg, acc, startTime, currentSessionId) {
         inputTokens: tokens.input,
         outputTokens: tokens.output,
         costUsd: totalCost,
-        durationMs
+        durationMs,
+        model: extractModel(msg)
       },
       sessionId: sid2
     };
@@ -66885,6 +66931,7 @@ function processRunMessage(message2, acc, startTime) {
   if (message2.subtype === "success") {
     acc.content = message2.result ?? "";
     acc.costUsd = message2.total_cost_usd ?? 0;
+    acc.model = extractModel(message2);
     const tokens = extractTokens(message2.usage);
     acc.inputTokens = tokens.input;
     acc.outputTokens = tokens.output;
@@ -67092,7 +67139,13 @@ class ClaudeCodeClient {
       runId: crypto.randomUUID(),
       sessionId: acc.sessionId,
       status: "completed",
-      metrics: { inputTokens: acc.inputTokens, outputTokens: acc.outputTokens, durationMs }
+      metrics: {
+        inputTokens: acc.inputTokens,
+        outputTokens: acc.outputTokens,
+        durationMs,
+        costUsd: acc.costUsd,
+        model: acc.model
+      }
     };
   }
   streamRun(request, streamConfig, abortSignal) {
@@ -67285,7 +67338,9 @@ class AgnoAgentProvider {
         durationMs,
         cost: response.metrics ? {
           inputTokens: response.metrics.inputTokens,
-          outputTokens: response.metrics.outputTokens
+          outputTokens: response.metrics.outputTokens,
+          costUsd: response.metrics.costUsd,
+          model: response.metrics.model
         } : undefined,
         customerErrorBlocked
       }
@@ -67543,7 +67598,12 @@ ${fileList}`;
         runId: response.runId,
         providerId: this.id,
         durationMs,
-        cost: response.metrics ? { inputTokens: response.metrics.inputTokens, outputTokens: response.metrics.outputTokens } : undefined
+        cost: response.metrics ? {
+          inputTokens: response.metrics.inputTokens,
+          outputTokens: response.metrics.outputTokens,
+          costUsd: response.metrics.costUsd,
+          model: response.metrics.model
+        } : undefined
       }
     };
   }
@@ -70773,6 +70833,7 @@ __export(exports_src, {
   boundedTenantLabel: () => boundedTenantLabel,
   armSequence: () => armSequence,
   appUptime: () => appUptime,
+  agentUsageFromResult: () => agentUsageFromResult,
   agentStateKey: () => agentStateKey,
   WhatsAppTemplateComponentSchema: () => WhatsAppTemplateComponentSchema,
   WhatsAppFlowSendSchema: () => WhatsAppFlowSendSchema,
@@ -70956,6 +71017,7 @@ __export(exports_src, {
   AutomationEngine: () => AutomationEngine,
   AgnoClient: () => AgnoClient,
   AgnoAgentProvider: () => AgnoAgentProvider,
+  AgentUsageSchema: () => AgentUsageSchema,
   AgentTypeSchema: () => AgentTypeSchema,
   AgentTaskStatusSchema: () => AgentTaskStatusSchema,
   AgentTaskSchema: () => AgentTaskSchema,
@@ -70978,6 +71040,7 @@ __export(exports_src, {
   AUTO_RETRY_DELAYS_MS: () => AUTO_RETRY_DELAYS_MS,
   AUTOMATION_LOG_STATUSES: () => AUTOMATION_LOG_STATUSES,
   AUTOMATION_DEBOUNCE_MODES: () => AUTOMATION_DEBOUNCE_MODES,
+  AGENT_USAGE_METADATA_KEY: () => AGENT_USAGE_METADATA_KEY,
   AGENT_TYPES: () => AGENT_TYPES,
   AGENT_STATE_KV_BUCKET: () => AGENT_STATE_KV_BUCKET,
   ACTION_TYPES: () => ACTION_TYPES,
@@ -74642,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";
@@ -74668,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;
@@ -74743,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)) {
@@ -84091,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;
@@ -100593,7 +100656,7 @@ var require_google_genai = __commonJS((exports) => {
   var constants = require_constants7();
   var streaming = require_streaming3();
   var utils$1 = require_utils11();
-  function extractModel(params, context) {
+  function extractModel2(params, context) {
     if ("model" in params && typeof params.model === "string") {
       return params.model;
     }
@@ -100637,7 +100700,7 @@ var require_google_genai = __commonJS((exports) => {
       [semanticAttributes.SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]: "auto.ai.google_genai"
     };
     if (params) {
-      attributes[genAiAttributes.GEN_AI_REQUEST_MODEL_ATTRIBUTE] = extractModel(params, context);
+      attributes[genAiAttributes.GEN_AI_REQUEST_MODEL_ATTRIBUTE] = extractModel2(params, context);
       if ("config" in params && typeof params.config === "object" && params.config) {
         const config2 = params.config;
         Object.assign(attributes, extractConfigAttributes(config2));
@@ -100647,7 +100710,7 @@ var require_google_genai = __commonJS((exports) => {
         }
       }
     } else {
-      attributes[genAiAttributes.GEN_AI_REQUEST_MODEL_ATTRIBUTE] = extractModel({}, context);
+      attributes[genAiAttributes.GEN_AI_REQUEST_MODEL_ATTRIBUTE] = extractModel2({}, context);
     }
     return attributes;
   }
@@ -100817,7 +100880,7 @@ var require_google_genai = __commonJS((exports) => {
   function instrumentGoogleGenAIClient(client, options3) {
     return createDeepProxy(client, "", utils4.resolveAIRecordingOptions(options3));
   }
-  exports.extractModel = extractModel;
+  exports.extractModel = extractModel2;
   exports.instrumentGoogleGenAIClient = instrumentGoogleGenAIClient;
 });
 
@@ -137125,7 +137188,7 @@ import { fileURLToPath } from "url";
 // package.json
 var package_default = {
   name: "@automagik/omni",
-  version: "2.260910.7",
+  version: "2.260910.9",
   repository: {
     type: "git",
     url: "git+https://github.com/automagik-dev/omni.git",
@@ -139224,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");
+  }
+  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;
   }
-  return { ok: true, conditions: conditions2, logic };
+  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");
@@ -139306,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) {
@@ -139346,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";
@@ -142418,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";
@@ -142611,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;
@@ -142626,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 {
@@ -142708,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) },
@@ -143616,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
@@ -143730,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({
@@ -143789,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();
@@ -143892,6 +143990,7 @@ function displayAnalytics(data2) {
       successRate: data2.successRate,
       avgProcessingMs: data2.avgProcessingTimeMs,
       avgAgentMs: data2.avgAgentTimeMs,
+      totalCostUsd: data2.totalCostUsd ?? 0,
       messageTypes: data2.messageTypes,
       instances: data2.instances,
       errorStages: data2.errorStages
@@ -143903,7 +144002,8 @@ function displayAnalytics(data2) {
       failed: data2.failedMessages,
       successRate: `${data2.successRate.toFixed(1)}%`,
       avgProcessingMs: data2.avgProcessingTimeMs ?? "-",
-      avgAgentMs: data2.avgAgentTimeMs ?? "-"
+      avgAgentMs: data2.avgAgentTimeMs ?? "-",
+      totalCostUsd: `$${(data2.totalCostUsd ?? 0).toFixed(4)}`
     });
     displayRecordBreakdown("Message Types", data2.messageTypes, "type");
     displayRecordBreakdown("Per Instance", data2.instances, "instanceId");
@@ -143975,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,
@@ -144034,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) {
@@ -144567,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() {
@@ -144611,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) {
@@ -144683,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) {
@@ -144701,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);
@@ -146417,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() {
@@ -146636,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 {
@@ -148039,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";
@@ -148272,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);
@@ -149444,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 = {
@@ -149487,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}`);
@@ -149562,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();
@@ -149583,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) {
@@ -151656,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;
@@ -151691,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();
@@ -152375,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"];
@@ -152463,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}`);
@@ -152678,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;
@@ -152692,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,
@@ -152749,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";
@@ -152759,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;
   }