@nikolasp98/minion 2026.7.12-dev.20260717012629 → 2026.7.16-dev

package/extensions/gmail-calendar/index.ts

@@ -5,6 +5,7 @@ import { registerOutlookAuthTools } from "./src/outlook-auth-tool.js";
 import { registerOutlookCalendarTools } from "./src/outlook-calendar-tools.js";
 import { registerOutlookMailTools } from "./src/outlook-mail-tools.js";
 import type { OutlookOAuthConfig } from "./src/outlook-oauth.js";
+import { registerPulseTools } from "./src/pulse-tools.js";
 
 type PluginConfig = {
   requireApproval?: boolean;
@@ -48,6 +49,9 @@ const plugin = {
     registerOutlookMailTools(api, outlookConfig, requireApproval);
     registerOutlookCalendarTools(api, outlookConfig, requireApproval);
 
+    // Pulse — proactive proposal cards posted to the Hub for user approval
+    registerPulseTools(api);
+
     api.logger.info(
       `gmail-calendar loaded — requireApproval=${requireApproval}, outlook=${!!outlookConfig.clientId}`,
     );

package/extensions/gmail-calendar/src/pulse-tools.test.ts

@@ -0,0 +1,14 @@
+import { describe, expect, it } from "vitest";
+import { buildPulseBody } from "./pulse-tools.js";
+
+describe("pulse_propose body", () => {
+  it("shapes orgId + proposals", () => {
+    const body = buildPulseBody("org-A", [
+      { source: "daily_briefing", kind: "digest", title: "Day", dedupKey: "k1" },
+    ]);
+    expect(body).toEqual({
+      orgId: "org-A",
+      proposals: [{ source: "daily_briefing", kind: "digest", title: "Day", dedupKey: "k1" }],
+    });
+  });
+});

package/extensions/gmail-calendar/src/pulse-tools.ts

@@ -0,0 +1,63 @@
+import { Type } from "@sinclair/typebox";
+import type { AnyAgentTool, MinionPluginApi, MinionPluginToolFactory } from "minion/plugin-sdk";
+import { getHubRest } from "../../../src/gateway/hub-rest-registry.js";
+
+function txt(text: string) {
+  return { content: [{ type: "text" as const, text }], details: { text } };
+}
+
+const CardSchema = Type.Object({
+  source: Type.String(),
+  kind: Type.String(),
+  title: Type.String(),
+  summary: Type.Optional(Type.String()),
+  payload: Type.Optional(Type.Record(Type.String(), Type.Unknown())),
+  dedupKey: Type.String(),
+});
+
+const PulseProposeSchema = Type.Object({
+  orgId: Type.String({ description: "Target org id (PINONITE)" }),
+  proposals: Type.Array(CardSchema),
+});
+
+/** Pure body shaper — kept separate from `execute` so it's unit-testable without network. */
+export function buildPulseBody(orgId: string, proposals: unknown[]) {
+  return { orgId, proposals };
+}
+
+export function registerPulseTools(api: MinionPluginApi): void {
+  const factory: MinionPluginToolFactory = (): AnyAgentTool[] => [
+    {
+      name: "pulse_propose",
+      label: "Propose Pulse cards",
+      description:
+        "Write proactive proposal cards (digest / create_event / reminder / draft_reply / fyi) " +
+        "to the Hub Pulse feed for the user to approve.",
+      parameters: PulseProposeSchema,
+      async execute(_id, params) {
+        const rest = getHubRest();
+        if (!rest) return txt("Pulse: hub not linked; skipped.");
+        const p = params as Record<string, unknown>;
+        const orgId = String(p.orgId ?? "");
+        const proposalsRaw = p.proposals;
+        const proposals = Array.isArray(proposalsRaw) ? proposalsRaw : [];
+        if (!orgId || !proposals.length) return txt("Pulse: nothing to propose.");
+        try {
+          const res = await fetch(`${rest.hubUrl.replace(/\/$/, "")}/api/gateway/pulse/proposals`, {
+            method: "POST",
+            headers: {
+              Authorization: `Bearer ${rest.serverToken}`,
+              "content-type": "application/json",
+            },
+            body: JSON.stringify(buildPulseBody(orgId, proposals)),
+          });
+          const j = (await res.json().catch(() => ({}))) as { inserted?: number; skipped?: number };
+          return txt(`Pulse: proposed ${j.inserted ?? 0}, skipped ${j.skipped ?? 0}.`);
+        } catch (e) {
+          return txt(`Pulse: post failed — ${e instanceof Error ? e.message : "error"}`);
+        }
+      },
+    },
+  ];
+  api.registerTool(factory, { names: ["pulse_propose"] });
+}

package/extensions/googlechat/index.js

@@ -4288,6 +4288,7 @@ const ChannelsSchema = z.object({
 		heartbeat: ChannelHeartbeatVisibilitySchema
 	}).strict().optional(),
 	accountOrgs: z.record(z.string(), z.record(z.string(), z.array(z.string()).optional()).optional()).optional(),
+	accountOwners: z.record(z.string(), z.record(z.string(), z.string().optional()).optional()).optional(),
 	whatsapp: WhatsAppConfigSchema.optional(),
 	telegram: TelegramConfigSchema.optional(),
 	discord: DiscordConfigSchema.optional(),

package/extensions/irc/index.js

@@ -4289,6 +4289,7 @@ const ChannelsSchema = z.object({
 		heartbeat: ChannelHeartbeatVisibilitySchema
 	}).strict().optional(),
 	accountOrgs: z.record(z.string(), z.record(z.string(), z.array(z.string()).optional()).optional()).optional(),
+	accountOwners: z.record(z.string(), z.record(z.string(), z.string().optional()).optional()).optional(),
 	whatsapp: WhatsAppConfigSchema.optional(),
 	telegram: TelegramConfigSchema.optional(),
 	discord: DiscordConfigSchema.optional(),

package/extensions/llm-task/index.js

@@ -4321,9 +4321,14 @@ function buildWorkspaceSkillSnapshot(workspaceDir, opts) {
 */
 function createGatewayDroneHost(opts = {}) {
 	const { config, agentDir, workspaceDir } = opts;
+	let resolvedModel;
 	return {
 		async resolveApiKey(spec) {
 			const auth = await resolveProvider(spec, config, agentDir);
+			resolvedModel = {
+				provider: spec.provider,
+				model: spec.model
+			};
 			return {
 				apiKey: requireApiKey(auth, spec.provider),
 				source: auth.source
@@ -4356,6 +4361,34 @@ function createGatewayDroneHost(opts = {}) {
 				},
 				timestamp: Date.now()
 			});
+			if (input.event === "agent.run.end" && input.usage && resolvedModel) {
+				const u = input.usage;
+				const inTok = u.inputTokens ?? 0;
+				const outTok = u.outputTokens ?? 0;
+				const cacheTok = u.cacheReadTokens ?? 0;
+				emitEvent({
+					category: "agent",
+					severity: "info",
+					event: "agent.llm.usage",
+					message: `Drone LLM usage: ${input.droneId}`,
+					correlationId: input.correlationId,
+					metadata: {
+						kind: "drone",
+						droneId: input.droneId,
+						provider: resolvedModel.provider,
+						model: resolvedModel.model,
+						source: "system",
+						channel: "drone",
+						tokens: {
+							input: inTok,
+							output: outTok,
+							cacheRead: cacheTok,
+							total: inTok + outTok + cacheTok
+						}
+					},
+					timestamp: Date.now()
+				});
+			}
 		}
 	};
 }

package/extensions/matrix/{credentials-BiYGX26F.mjs → credentials-B_Avjvsy.mjs}

@@ -4286,6 +4286,7 @@ const ChannelsSchema = z.object({
 		heartbeat: ChannelHeartbeatVisibilitySchema
 	}).strict().optional(),
 	accountOrgs: z.record(z.string(), z.record(z.string(), z.array(z.string()).optional()).optional()).optional(),
+	accountOwners: z.record(z.string(), z.record(z.string(), z.string().optional()).optional()).optional(),
 	whatsapp: WhatsAppConfigSchema.optional(),
 	telegram: TelegramConfigSchema.optional(),
 	discord: DiscordConfigSchema.optional(),

package/extensions/matrix/index.js

@@ -1,5 +1,5 @@
-import { a as setMatrixRuntime, i as getMatrixRuntime } from "./credentials-BiYGX26F.mjs";
-import { A as listMatrixAccountIds, I as resolveMatrixAuth, M as resolveMatrixAccount, N as resolveMatrixAccountConfig, S as sendPollMatrix, T as resolveMatrixRoomId, _ as RelationType, b as reactMatrixMessage, c as listMatrixDirectoryGroupsLive, d as removeMatrixReactions, f as fetchEventSummary, g as MsgType, h as EventType, i as normalizeMatrixUserId, j as resolveDefaultMatrixAccountId, l as listMatrixDirectoryPeersLive, m as summarizeMatrixRawEvent, n as probeMatrix, p as readPinnedEvents, r as normalizeMatrixAllowList, s as resolveMatrixRoomConfig, t as resolveMatrixTargets, u as listMatrixReactions, v as resolveMatrixActionLimit, x as sendMessageMatrix, y as resolveActionClient } from "./resolve-targets-BPyBSXgs.mjs";
+import { a as setMatrixRuntime, i as getMatrixRuntime } from "./credentials-B_Avjvsy.mjs";
+import { A as listMatrixAccountIds, I as resolveMatrixAuth, M as resolveMatrixAccount, N as resolveMatrixAccountConfig, S as sendPollMatrix, T as resolveMatrixRoomId, _ as RelationType, b as reactMatrixMessage, c as listMatrixDirectoryGroupsLive, d as removeMatrixReactions, f as fetchEventSummary, g as MsgType, h as EventType, i as normalizeMatrixUserId, j as resolveDefaultMatrixAccountId, l as listMatrixDirectoryPeersLive, m as summarizeMatrixRawEvent, n as probeMatrix, p as readPinnedEvents, r as normalizeMatrixAllowList, s as resolveMatrixRoomConfig, t as resolveMatrixTargets, u as listMatrixReactions, v as resolveMatrixActionLimit, x as sendMessageMatrix, y as resolveActionClient } from "./resolve-targets-Bv0B2AJv.mjs";
 import { createRequire } from "node:module";
 import { MarkdownConfigSchema, ToolPolicySchema, emptyPluginConfigSchema, maybeInjectDisclosure, resolveDisclosureConfig } from "minion/plugin-sdk";
 import { DEFAULT_ACCOUNT_ID, PAIRING_APPROVED_MESSAGE, addWildcardAllowFrom, applyAccountNameToChannelSection, buildChannelConfigSchema, createActionGate, deleteAccountFromConfigSection, formatDocsLink, formatPairingApproveHint, jsonResult, mergeAllowFromEntries, normalizeAccountId, promptChannelAccessConfig, readNumberParam, readReactionParams, readStringParam, setAccountEnabledInConfigSection } from "openclaw/plugin-sdk";
@@ -1298,7 +1298,7 @@ const matrixPlugin = {
 		await previousLock;
 		let monitorMatrixProvider;
 		try {
-			monitorMatrixProvider = (await import("./matrix-Dqf7qlT1.mjs")).monitorMatrixProvider;
+			monitorMatrixProvider = (await import("./matrix-Dy31zmus.mjs")).monitorMatrixProvider;
 		} finally {
 			releaseLock();
 		}

package/extensions/matrix/{matrix-Dqf7qlT1.mjs → matrix-Dy31zmus.mjs}

@@ -1,5 +1,5 @@
-import { i as getMatrixRuntime } from "./credentials-BiYGX26F.mjs";
-import { C as sendReadReceiptMatrix, D as formatPollAsText, E as setActiveMatrixClient, F as stopSharedClientForAccount, I as resolveMatrixAuth, L as require_lib, M as resolveMatrixAccount, O as isPollStartType, P as resolveSharedMatrixClient, R as isBunRuntime, a as resolveMatrixAllowListMatch, b as reactMatrixMessage, d as removeMatrixReactions, f as fetchEventSummary, i as normalizeMatrixUserId, k as parsePollStartContent, o as resolveMatrixAllowListMatches, r as normalizeMatrixAllowList, s as resolveMatrixRoomConfig, t as resolveMatrixTargets, w as sendTypingMatrix, x as sendMessageMatrix } from "./resolve-targets-BPyBSXgs.mjs";
+import { i as getMatrixRuntime } from "./credentials-B_Avjvsy.mjs";
+import { C as sendReadReceiptMatrix, D as formatPollAsText, E as setActiveMatrixClient, F as stopSharedClientForAccount, I as resolveMatrixAuth, L as require_lib, M as resolveMatrixAccount, O as isPollStartType, P as resolveSharedMatrixClient, R as isBunRuntime, a as resolveMatrixAllowListMatch, b as reactMatrixMessage, d as removeMatrixReactions, f as fetchEventSummary, i as normalizeMatrixUserId, k as parsePollStartContent, o as resolveMatrixAllowListMatches, r as normalizeMatrixAllowList, s as resolveMatrixRoomConfig, t as resolveMatrixTargets, w as sendTypingMatrix, x as sendMessageMatrix } from "./resolve-targets-Bv0B2AJv.mjs";
 import { createReplyPrefixOptions, createTypingCallbacks, formatAllowlistMatchMeta, formatLocationText, logInboundDrop, logTypingFailure, resolveControlCommandGate, toLocationContext } from "minion/plugin-sdk";
 import { mergeAllowlist, summarizeMapping } from "openclaw/plugin-sdk";
 import { format } from "node:util";

package/extensions/matrix/{resolve-targets-BPyBSXgs.mjs → resolve-targets-Bv0B2AJv.mjs}

@@ -1,5 +1,5 @@
 import { i as __toESM, r as __require, t as __commonJSMin } from "./rolldown-runtime-JspESFgx.mjs";
-import { i as getMatrixRuntime, o as DEFAULT_ACCOUNT_ID, r as loadMatrixCredentials, s as normalizeAccountId, t as credentialsMatchConfig } from "./credentials-BiYGX26F.mjs";
+import { i as getMatrixRuntime, o as DEFAULT_ACCOUNT_ID, r as loadMatrixCredentials, s as normalizeAccountId, t as credentialsMatchConfig } from "./credentials-B_Avjvsy.mjs";
 import { t as require_matrix_sdk_crypto_nodejs } from "./matrix-sdk-crypto-nodejs-CRHvexDX.mjs";
 import { buildChannelKeyCandidates, resolveChannelEntryMatch } from "minion/plugin-sdk";
 import path from "node:path";
@@ -87382,7 +87382,7 @@ async function resolveMatrixAuth(params) {
 	const env = params?.env ?? process.env;
 	const resolved = resolveMatrixConfigForAccount(cfg, params?.accountId, env);
 	if (!resolved.homeserver) throw new Error("Matrix homeserver is required (matrix.homeserver)");
-	const { loadMatrixCredentials, saveMatrixCredentials, credentialsMatchConfig, touchMatrixCredentials } = await import("./credentials-BiYGX26F.mjs").then((n) => n.n);
+	const { loadMatrixCredentials, saveMatrixCredentials, credentialsMatchConfig, touchMatrixCredentials } = await import("./credentials-B_Avjvsy.mjs").then((n) => n.n);
 	const accountId = params?.accountId;
 	const cached = loadMatrixCredentials(env, accountId);
 	const cachedCredentials = cached && credentialsMatchConfig(cached, {

package/extensions/mattermost/index.js

@@ -4333,6 +4333,7 @@ const ChannelsSchema = z.object({
 		heartbeat: ChannelHeartbeatVisibilitySchema
 	}).strict().optional(),
 	accountOrgs: z.record(z.string(), z.record(z.string(), z.array(z.string()).optional()).optional()).optional(),
+	accountOwners: z.record(z.string(), z.record(z.string(), z.string().optional()).optional()).optional(),
 	whatsapp: WhatsAppConfigSchema.optional(),
 	telegram: TelegramConfigSchema.optional(),
 	discord: DiscordConfigSchema.optional(),

package/extensions/meta-graph/index.js

@@ -235,6 +235,7 @@ function createMetaProcessor(params) {
 			const core = getMetaRuntime();
 			const messages = adapter.extractMessages(entry, account);
 			for (const message of messages) {
+				if (message.referral) params.onReferral?.(message);
 				env.statusSink?.({ lastInboundAt: Date.now() });
 				try {
 					await handleInbound({
@@ -467,13 +468,16 @@ function extractMessagingEvents(entry) {
 			url: attachment.payload.url,
 			mimeType: attachmentMime(attachment.type)
 		} : void 0;
-		if (!text && !media) continue;
+		const referral = raw.message?.referral;
+		if (!text && !media && !referral) continue;
 		out.push({
 			senderId,
 			text,
 			messageId: raw.message?.mid,
 			timestampMs: typeof raw.timestamp === "number" ? raw.timestamp : void 0,
-			media
+			media,
+			referral,
+			recipientId: raw.recipient?.id?.trim() || void 0
 		});
 	}
 	return out;
@@ -487,6 +491,40 @@ function attachmentMime(type) {
 	].includes(type)) return `${type}/*`;
 	return "application/octet-stream";
 }
+function resolveRelayConfig(cfg) {
+	const pc = cfg.plugins?.entries?.["meta-graph"]?.config ?? {};
+	const hubUrl = (pc.hubUrl?.trim() || process.env.HUB_URL?.trim() || "").replace(/\/+$/, "");
+	const cronSecret = pc.cronSecret?.trim() || process.env.CRON_SECRET?.trim() || "";
+	if (!hubUrl || !cronSecret) return null;
+	return {
+		hubUrl,
+		cronSecret
+	};
+}
+/** Fire-and-forget POST of an ad referral to the hub. Never throws. */
+function relayAdReferral(relay, channel, message, log) {
+	const referral = message.referral;
+	if (!referral) return;
+	if (!((referral.source ?? "").toUpperCase() === "ADS" || Boolean(referral.ad_id)) || !message.recipientId) return;
+	const body = {
+		channel,
+		senderId: message.senderId,
+		recipientId: message.recipientId,
+		messageId: message.messageId ?? null,
+		timestampMs: message.timestampMs ?? null,
+		referral
+	};
+	fetch(`${relay.hubUrl}/api/meta/attribution`, {
+		method: "POST",
+		headers: {
+			"content-type": "application/json",
+			authorization: `Bearer ${relay.cronSecret}`
+		},
+		body: JSON.stringify(body)
+	}).then((res) => {
+		if (!res.ok) log?.(`[${channel}] attribution relay non-ok: ${res.status}`);
+	}).catch((err) => log?.(`[${channel}] attribution relay failed: ${String(err)}`));
+}
 async function sendMessagingText(params) {
 	const res = await graphSend({
 		nodeId: params.nodeId,
@@ -770,6 +808,7 @@ function createMessagingPlatformChannel(spec) {
 				appSecret: account.appSecret ?? "",
 				verifyToken: account.verifyToken ?? ""
 			});
+			const relay = resolveRelayConfig(ctx.cfg);
 			const offProc = registerMetaProcessor(registry, spec.objectType, createMetaProcessor({
 				adapter: adapterFor(spec),
 				account,
@@ -781,7 +820,8 @@ function createMessagingPlatformChannel(spec) {
 						accountId: account.accountId,
 						...patch
 					})
-				}
+				},
+				onReferral: relay ? (message) => relayAdReferral(relay, spec.channelId, message, (m) => ctx.log?.info?.(m)) : void 0
 			}));
 			try {
 				await waitForAbort(ctx.abortSignal);

package/extensions/meta-graph/minion.manifest.ts

@@ -17,6 +17,9 @@ const MetaGraphConfigSchema = z
     verifyToken: z.string().optional(),
     graphVersion: z.string().optional(),
     webhookPath: z.string().optional(),
+    // Tier 3 ad-attribution relay target (env fallbacks: HUB_URL / CRON_SECRET).
+    hubUrl: z.string().optional(),
+    cronSecret: z.string().optional(),
   })
   .loose();
 

package/extensions/meta-graph/minion.plugin.json

@@ -17,11 +17,17 @@
       },
       "webhookPath": {
         "type": "string"
+      },
+      "hubUrl": {
+        "type": "string"
+      },
+      "cronSecret": {
+        "type": "string"
       }
     },
     "additionalProperties": {}
   },
-  "_schemaChecksum": "c1ff2234836d7b21",
+  "_schemaChecksum": "97e5f6131c1544af",
   "icon": "whatsapp",
   "channels": [
     "whatsapp-cloud",

package/extensions/meta-graph/src/channels/messaging-platform.ts

@@ -23,6 +23,7 @@ import { readMetaApp, resolveAccessToken, resolveAppCredentials } from "./meta-a
 import {
   createMetaProcessor,
   waitForAbort,
+  type MetaAdReferral,
   type MetaChannelAdapter,
   type MetaInboundMessage,
   type MetaResolvedAccountBase,
@@ -38,6 +39,8 @@ type MessagingEvent = {
     text?: string;
     is_echo?: boolean;
     attachments?: Array<{ type?: string; payload?: { url?: string } }>;
+    /** Click-to-Direct ad referral, present only on the first message of an ad thread. */
+    referral?: MetaAdReferral;
   };
   postback?: { title?: string; payload?: string };
   delivery?: unknown;
@@ -55,13 +58,18 @@ export function extractMessagingEvents(entry: MetaWebhookEntry): MetaInboundMess
     const media = attachment?.payload?.url
       ? { url: attachment.payload.url, mimeType: attachmentMime(attachment.type) }
       : undefined;
-    if (!text && !media) continue;
+    const referral = raw.message?.referral;
+    // Keep ad-referral events even when they carry no text/media: the referral
+    // is the attribution signal (handleInbound still skips the empty body).
+    if (!text && !media && !referral) continue;
     out.push({
       senderId,
       text,
       messageId: raw.message?.mid,
       timestampMs: typeof raw.timestamp === "number" ? raw.timestamp : undefined,
       media,
+      referral,
+      recipientId: raw.recipient?.id?.trim() || undefined,
     });
   }
   return out;
@@ -73,6 +81,58 @@ function attachmentMime(type?: string): string | undefined {
   return "application/octet-stream";
 }
 
+// --- Ad-attribution relay (Tier 3) --------------------------------------------
+// On the first message of a Click-to-Direct ad thread, forward the referral to
+// the hub so it can resolve the campaign and store the lead's origin. Config
+// mirrors the Meta app creds: plugin config → env fallback.
+
+type RelayConfig = { hubUrl: string; cronSecret: string };
+
+function resolveRelayConfig(cfg: MinionConfig): RelayConfig | null {
+  const pc =
+    (cfg as { plugins?: { entries?: Record<string, { config?: Record<string, unknown> }> } })
+      .plugins?.entries?.["meta-graph"]?.config ?? {};
+  const hubUrl = (
+    (pc.hubUrl as string | undefined)?.trim() ||
+    process.env.HUB_URL?.trim() ||
+    ""
+  ).replace(/\/+$/, "");
+  const cronSecret =
+    (pc.cronSecret as string | undefined)?.trim() || process.env.CRON_SECRET?.trim() || "";
+  if (!hubUrl || !cronSecret) return null;
+  return { hubUrl, cronSecret };
+}
+
+/** Fire-and-forget POST of an ad referral to the hub. Never throws. */
+function relayAdReferral(
+  relay: RelayConfig,
+  channel: string,
+  message: MetaInboundMessage,
+  log?: (m: string) => void,
+): void {
+  const referral = message.referral;
+  if (!referral) return;
+  const isAd = (referral.source ?? "").toUpperCase() === "ADS" || Boolean(referral.ad_id);
+  if (!isAd || !message.recipientId) return; // recipient id is required to map an org
+  const body = {
+    channel,
+    senderId: message.senderId,
+    recipientId: message.recipientId,
+    messageId: message.messageId ?? null,
+    timestampMs: message.timestampMs ?? null,
+    referral,
+  };
+  void fetch(`${relay.hubUrl}/api/meta/attribution`, {
+    method: "POST",
+    headers: { "content-type": "application/json", authorization: `Bearer ${relay.cronSecret}` },
+    body: JSON.stringify(body),
+  })
+    .then((res) => {
+      if (!res.ok) log?.(`[${channel}] attribution relay non-ok: ${res.status}`);
+    })
+    .catch((err) => log?.(`[${channel}] attribution relay failed: ${String(err)}`));
+}
+
 async function sendMessagingText(params: {
   nodeId: string;
   accessToken: string;
@@ -360,6 +420,7 @@ export function createMessagingPlatformChannel(
           appSecret: account.appSecret ?? "",
           verifyToken: account.verifyToken ?? "",
         });
+        const relay = resolveRelayConfig(ctx.cfg);
         const offProc = registerMetaProcessor(
           registry,
           spec.objectType,
@@ -372,6 +433,10 @@ export function createMessagingPlatformChannel(
               error: (m) => ctx.log?.error?.(m),
               statusSink: (patch) => ctx.setStatus({ accountId: account.accountId, ...patch }),
             },
+            onReferral: relay
+              ? (message) =>
+                  relayAdReferral(relay, spec.channelId, message, (m) => ctx.log?.info?.(m))
+              : undefined,
           }),
         );
         // Webhook channel: stay running until aborted (see waitForAbort docs).

package/extensions/meta-graph/src/channels/shared.ts

@@ -12,6 +12,19 @@ import { getMetaRuntime } from "../runtime.js";
 import type { MetaObjectType, MetaWebhookEntry } from "../types.js";
 import type { MetaDmPolicy } from "./config.js";
 
+/** IG/Messenger Click-to-Direct `message.referral` (verbatim webhook shape). */
+export type MetaAdReferral = {
+  ref?: string | null;
+  ad_id?: string | null;
+  source?: string | null; // 'ADS'
+  type?: string | null; // 'OPEN_THREAD'
+  ads_context_data?: {
+    ad_title?: string | null;
+    photo_url?: string | null;
+    video_url?: string | null;
+  } | null;
+};
+
 export type MetaInboundMessage = {
   senderId: string;
   senderName?: string;
@@ -19,6 +32,10 @@ export type MetaInboundMessage = {
   messageId?: string;
   timestampMs?: number;
   media?: { id?: string; url?: string; mimeType?: string; fileName?: string };
+  /** Click-to-Direct ad referral, present only on the FIRST message of an ad-driven thread. */
+  referral?: MetaAdReferral;
+  /** Webhook `recipient.id` (the IG business / Page id) — maps to an org on the hub side. */
+  recipientId?: string;
 };
 
 export type MetaResolvedAccountBase = {
@@ -68,6 +85,9 @@ export function createMetaProcessor<A extends MetaResolvedAccountBase>(params: {
   account: A;
   cfg: MinionConfig;
   env: MetaProcessorEnv;
+  /** Fired (fire-and-forget) for every inbound message carrying an ad referral,
+   *  independent of whether the message itself is dispatched to an agent. */
+  onReferral?: (message: MetaInboundMessage) => void;
 }): MetaProcessor {
   const { adapter, account, cfg, env } = params;
   const wantId = adapter.entryId(account);
@@ -78,6 +98,7 @@ export function createMetaProcessor<A extends MetaResolvedAccountBase>(params: {
       const core = getMetaRuntime();
       const messages = adapter.extractMessages(entry, account);
       for (const message of messages) {
+        if (message.referral) params.onReferral?.(message);
         env.statusSink?.({ lastInboundAt: Date.now() });
         try {
           await handleInbound({ adapter, account, cfg, env, core, message });

package/extensions/nextcloud-talk/index.js

@@ -4288,6 +4288,7 @@ const ChannelsSchema = z.object({
 		heartbeat: ChannelHeartbeatVisibilitySchema
 	}).strict().optional(),
 	accountOrgs: z.record(z.string(), z.record(z.string(), z.array(z.string()).optional()).optional()).optional(),
+	accountOwners: z.record(z.string(), z.record(z.string(), z.string().optional()).optional()).optional(),
 	whatsapp: WhatsAppConfigSchema.optional(),
 	telegram: TelegramConfigSchema.optional(),
 	discord: DiscordConfigSchema.optional(),

package/extensions/tlon/index.js

@@ -4376,9 +4376,14 @@ function buildWorkspaceSkillSnapshot(workspaceDir, opts) {
 */
 function createGatewayDroneHost(opts = {}) {
 	const { config, agentDir, workspaceDir } = opts;
+	let resolvedModel;
 	return {
 		async resolveApiKey(spec) {
 			const auth = await resolveProvider(spec, config, agentDir);
+			resolvedModel = {
+				provider: spec.provider,
+				model: spec.model
+			};
 			return {
 				apiKey: requireApiKey(auth, spec.provider),
 				source: auth.source
@@ -4411,6 +4416,34 @@ function createGatewayDroneHost(opts = {}) {
 				},
 				timestamp: Date.now()
 			});
+			if (input.event === "agent.run.end" && input.usage && resolvedModel) {
+				const u = input.usage;
+				const inTok = u.inputTokens ?? 0;
+				const outTok = u.outputTokens ?? 0;
+				const cacheTok = u.cacheReadTokens ?? 0;
+				emitEvent({
+					category: "agent",
+					severity: "info",
+					event: "agent.llm.usage",
+					message: `Drone LLM usage: ${input.droneId}`,
+					correlationId: input.correlationId,
+					metadata: {
+						kind: "drone",
+						droneId: input.droneId,
+						provider: resolvedModel.provider,
+						model: resolvedModel.model,
+						source: "system",
+						channel: "drone",
+						tokens: {
+							input: inTok,
+							output: outTok,
+							cacheRead: cacheTok,
+							total: inTok + outTok + cacheTok
+						}
+					},
+					timestamp: Date.now()
+				});
+			}
 		}
 	};
 }

package/extensions/wati/index.js

@@ -4298,6 +4298,7 @@ const ChannelsSchema = z.object({
 		heartbeat: ChannelHeartbeatVisibilitySchema
 	}).strict().optional(),
 	accountOrgs: z.record(z.string(), z.record(z.string(), z.array(z.string()).optional()).optional()).optional(),
+	accountOwners: z.record(z.string(), z.record(z.string(), z.string().optional()).optional()).optional(),
 	whatsapp: WhatsAppConfigSchema.optional(),
 	telegram: TelegramConfigSchema.optional(),
 	discord: DiscordConfigSchema.optional(),

package/extensions/weixin/index.js

@@ -4287,6 +4287,7 @@ const ChannelsSchema = z.object({
 		heartbeat: ChannelHeartbeatVisibilitySchema
 	}).strict().optional(),
 	accountOrgs: z.record(z.string(), z.record(z.string(), z.array(z.string()).optional()).optional()).optional(),
+	accountOwners: z.record(z.string(), z.record(z.string(), z.string().optional()).optional()).optional(),
 	whatsapp: WhatsAppConfigSchema.optional(),
 	telegram: TelegramConfigSchema.optional(),
 	discord: DiscordConfigSchema.optional(),

package/extensions/zalo/index.js

@@ -4298,6 +4298,7 @@ const ChannelsSchema = z.object({
 		heartbeat: ChannelHeartbeatVisibilitySchema
 	}).strict().optional(),
 	accountOrgs: z.record(z.string(), z.record(z.string(), z.array(z.string()).optional()).optional()).optional(),
+	accountOwners: z.record(z.string(), z.record(z.string(), z.string().optional()).optional()).optional(),
 	whatsapp: WhatsAppConfigSchema.optional(),
 	telegram: TelegramConfigSchema.optional(),
 	discord: DiscordConfigSchema.optional(),

package/extensions/zalouser/index.js

@@ -4288,6 +4288,7 @@ const ChannelsSchema = z.object({
 		heartbeat: ChannelHeartbeatVisibilitySchema
 	}).strict().optional(),
 	accountOrgs: z.record(z.string(), z.record(z.string(), z.array(z.string()).optional()).optional()).optional(),
+	accountOwners: z.record(z.string(), z.record(z.string(), z.string().optional()).optional()).optional(),
 	whatsapp: WhatsAppConfigSchema.optional(),
 	telegram: TelegramConfigSchema.optional(),
 	discord: DiscordConfigSchema.optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nikolasp98/minion",
-  "version": "2026.7.12-dev.20260717012629",
+  "version": "2026.7.16-dev",
   "description": "Multi-channel AI gateway with extensible messaging integrations",
   "keywords": [],
   "homepage": "https://github.com/NikolasP98/minion-ai#readme",

package/dist/daemon-install-helpers-7XKlSxjN.js

@@ -1,2 +0,0 @@
-import "./daemon-runtime-BhDDZrXa.js";
-export {};

package/dist/daemon-install-helpers-BItV2t5d.js

@@ -1,2 +0,0 @@
-import "./daemon-runtime-CAiL2S2s.js";
-export {};

package/dist/doctor-completion-8gqw3zRt.js

@@ -1,2 +0,0 @@
-import "./doctor-completion-DWJ2fJLm.js";
-export {};

package/dist/doctor-completion-uY7s1Gdv.js

@@ -1,2 +0,0 @@
-import "./doctor-completion-BPELnU8c.js";
-export {};

package/dist/web-BfUZ3tIc.js

@@ -1,2 +0,0 @@
-import { o as sendMessageWhatsApp } from "./channel-web-DOEUixG-.js";
-export { sendMessageWhatsApp };