@honor-claw/yoyo 2026.9.2-beta.2 → 2026.9.3-alpha.1

package/dist/capabilities/cron/delivery-capture.mjs

@@ -0,0 +1,49 @@
+import { clawLogger as e } from "../../utils/claw-logger.mjs";
+import { resolveChatIdFromTo as t } from "../../messaging/target/outbound.mjs";
+import "../../messaging/target/index.mjs";
+import { findCronJobById as n } from "./service.mjs";
+//#region src/capabilities/cron/delivery-capture.ts
+var r = e("cron"), i = /* @__PURE__ */ new Map(), a = 360 * 60 * 1e3;
+async function o(e) {
+	d();
+	let a = u((await n(e))?.delivery);
+	if (a === void 0) {
+		r.debug("cron job delivery capture missed", { jobId: e });
+		return;
+	}
+	let o = await t(a);
+	if (o === void 0) {
+		r.debug("cron job delivery capture skipped: target not a yoyo chat", {
+			jobId: e,
+			to: a
+		});
+		return;
+	}
+	i.set(e, {
+		chatId: o,
+		capturedAtMs: Date.now()
+	}), r.debug("cron job delivery captured", {
+		jobId: e,
+		chatId: o
+	});
+}
+function s(e) {
+	let t = i.get(e);
+	if (t !== void 0) return i.delete(e), t.chatId;
+}
+function c(e) {
+	i.delete(e);
+}
+async function l(e) {
+	let r = u((await n(e))?.delivery);
+	if (r !== void 0) return t(r);
+}
+function u(e) {
+	if (!(typeof e?.to != "string" || e.to.length === 0 || e.mode === "none")) return e.to;
+}
+function d() {
+	let e = Date.now() - a;
+	for (let [t, n] of i) n.capturedAtMs < e && i.delete(t);
+}
+//#endregion
+export { o as captureCronJobDelivery, c as clearCapturedCronJobDelivery, l as findCronJobDeliveryChatId, s as takeCapturedCronJobDelivery };

package/dist/capabilities/cron/events.mjs

@@ -0,0 +1,93 @@
+import { toErrorMessage as e } from "../../utils/error.mjs";
+import { clawLogger as t } from "../../utils/claw-logger.mjs";
+import { uuid as n } from "../../utils/id.mjs";
+import { buildChatTo as r, readChatIdFromSessionKey as i } from "../../messaging/target/address.mjs";
+import { resolveOutboundTarget as a } from "../../messaging/target/outbound.mjs";
+import "../../messaging/target/index.mjs";
+import { pushNotification as o } from "../../messaging/notification/notify.mjs";
+import { CronRunStatus as s } from "../../messaging/notification/types.mjs";
+import "../../messaging/notification/index.mjs";
+import { findCronJobDeliveryChatId as c } from "./delivery-capture.mjs";
+import { stringifyValue as l } from "../../utils/stringify.mjs";
+//#region src/capabilities/cron/events.ts
+var u = t("cron");
+async function d(t, n) {
+	try {
+		u.info("cron finished event received", {
+			jobId: t.jobId,
+			status: t.status,
+			name: t.job?.name,
+			runAtMs: t.runAtMs,
+			durationMs: t.durationMs,
+			sessionKey: t.sessionKey
+		});
+		let s = i(t.sessionKey), d = s ?? n ?? await c(t.jobId);
+		if (d === void 0) {
+			let e = {
+				jobId: t.jobId,
+				name: t.job?.name,
+				sessionKey: t.sessionKey ?? null,
+				sessionTarget: t.sessionTarget ?? null,
+				jobSessionTarget: t.job?.sessionTarget ?? null,
+				agentId: t.agentId ?? null,
+				sessionId: t.sessionId ?? null,
+				runId: t.runId ?? null
+			};
+			if (t.job?.payload?.kind === "heartbeat") {
+				u.debug("cron finished not routable: built-in heartbeat has no yoyo target, skip push", e);
+				return;
+			}
+			u.warn("cron finished event not routable: no yoyo session and no job delivery, skip push", e), u.debug("cron finished event raw payload", {
+				jobId: t.jobId,
+				raw: l(t)
+			});
+			return;
+		}
+		let p;
+		try {
+			p = await a(r(d));
+		} catch (n) {
+			u.warn("cron finished event not routable: chatId unresolvable, skip push", {
+				jobId: t.jobId,
+				chatId: d,
+				error: e(n)
+			});
+			return;
+		}
+		u.info("cron push target resolved", {
+			jobId: t.jobId,
+			chatId: d,
+			routedBy: s ? "sessionKey" : n === void 0 ? "listDelivery" : "capturedDelivery",
+			accountId: p.accountId,
+			deviceId: p.deviceId
+		});
+		let m = f(t), h = await o(p, m);
+		u.info("cron finished push dispatched", {
+			jobId: t.jobId,
+			notificationId: m.id,
+			realtimeSent: h !== null,
+			queued: h === null
+		});
+	} catch (e) {
+		u.error("failed to push cron finished event", e, { jobId: t.jobId });
+	}
+}
+function f(e) {
+	let t = e.status === "error", r = e.runAtMs != null && e.durationMs != null ? e.runAtMs + e.durationMs : Date.now();
+	return {
+		id: n(),
+		type: "cron",
+		severity: t ? "error" : "info",
+		occurredAt: r,
+		ack: !0,
+		cron: {
+			jobId: e.jobId,
+			name: e.job?.name ?? e.jobId,
+			status: t ? s.Failed : s.Success,
+			...e.summary === void 0 ? {} : { summary: e.summary },
+			...t && e.error ? { error: e.error } : {}
+		}
+	};
+}
+//#endregion
+export { d as pushCronFinishedEvent };

package/dist/capabilities/cron/index.mjs

@@ -0,0 +1,3 @@
+import "./service.mjs";
+import "./delivery-capture.mjs";
+import "./events.mjs";

package/dist/capabilities/cron/service.mjs

@@ -0,0 +1,140 @@
+import { toErrorMessage as e } from "../../utils/error.mjs";
+import { clawLogger as t } from "../../utils/claw-logger.mjs";
+import { findChatId as n } from "../../messaging/target/chat-id-store.mjs";
+import { resolveChatIdFromTo as r } from "../../messaging/target/outbound.mjs";
+import "../../messaging/target/index.mjs";
+import { CronRunStatus as i } from "../../messaging/notification/types.mjs";
+import "../../messaging/notification/index.mjs";
+//#region src/capabilities/cron/service.ts
+var a = t("cron"), o = 50, s;
+function c(e) {
+	s = e, a.info("cron service handle updated", { available: e !== void 0 });
+}
+function l() {
+	s = void 0;
+}
+async function u(t, r) {
+	let i = await n(t, r);
+	if (!i) return a.info("cron list: request device has no chat mapping, empty result", {
+		accountId: t,
+		requestDeviceId: r
+	}), {
+		ok: !0,
+		jobs: [],
+		total: 0
+	};
+	let c = s;
+	if (!c) return {
+		ok: !1,
+		error: "cron_unavailable"
+	};
+	let l;
+	try {
+		l = await c.list({ includeDisabled: !0 });
+	} catch (t) {
+		return a.error("cron list failed", t), {
+			ok: !1,
+			error: e(t)
+		};
+	}
+	let u = [];
+	for (let e of l) {
+		if (!await p(e, t, i)) continue;
+		let n = m(e);
+		n && u.push(n);
+	}
+	return a.info("cron list for chat", {
+		accountId: t,
+		requestDeviceId: r,
+		requestChatId: i,
+		total: l.length,
+		owned: u.length,
+		returned: Math.min(u.length, o)
+	}), {
+		ok: !0,
+		jobs: u.slice(0, o),
+		total: l.length
+	};
+}
+async function d(t) {
+	let n = s;
+	if (n) try {
+		return (await n.list({ includeDisabled: !1 })).find((e) => e?.id === t);
+	} catch (n) {
+		a.warn("cron job lookup failed", {
+			jobId: t,
+			error: e(n)
+		});
+		return;
+	}
+}
+async function f(t) {
+	let n = s;
+	if (!n) return {
+		ok: !1,
+		error: "cron_unavailable"
+	};
+	try {
+		return {
+			ok: !0,
+			removed: (await n.remove(t))?.removed === !0
+		};
+	} catch (n) {
+		return a.error("cron remove failed", n, { jobId: t }), {
+			ok: !1,
+			error: e(n)
+		};
+	}
+}
+async function p(e, t, n) {
+	let i = e.delivery?.to;
+	return typeof i != "string" || i.length === 0 ? !1 : await r(i, t) === n;
+}
+function m(e) {
+	if (e.enabled !== !0) return;
+	let t = h(e.schedule);
+	if (!t) return;
+	let n = e.state, r = n?.lastRunAtMs;
+	if (r != null) {
+		let e = n?.nextRunAtMs;
+		if (e == null || e <= r) return;
+	}
+	return {
+		jobId: e.id,
+		name: e.name ?? e.id,
+		...e.description ? { description: e.description } : {},
+		schedule: t,
+		nextRunAtMs: n?.nextRunAtMs ?? null,
+		...n?.lastRunStatus === void 0 ? {} : { lastRunStatus: g(n.lastRunStatus) },
+		...r === void 0 ? {} : { lastRunAtMs: r }
+	};
+}
+function h(e) {
+	switch (e?.kind) {
+		case "cron": return {
+			kind: "cron",
+			...e.expr === void 0 ? {} : { expr: e.expr },
+			...e.tz === void 0 ? {} : { tz: e.tz },
+			...e.staggerMs === void 0 ? {} : { staggerMs: e.staggerMs }
+		};
+		case "at": return {
+			kind: "at",
+			...e.at === void 0 ? {} : { at: e.at }
+		};
+		case "every": return {
+			kind: "every",
+			...e.everyMs === void 0 ? {} : { everyMs: e.everyMs },
+			...e.anchorMs === void 0 ? {} : { anchorMs: e.anchorMs }
+		};
+		default: return;
+	}
+}
+function g(e) {
+	switch (e) {
+		case "ok": return i.Success;
+		case "error": return i.Failed;
+		case "skipped": return i.Skipped;
+	}
+}
+//#endregion
+export { c as captureCronService, d as findCronJobById, u as listCronJobsForChat, l as releaseCronService, f as removeCronJob };

package/dist/capabilities/node/device-target.mjs

@@ -0,0 +1,49 @@
+import { toErrorMessage as e } from "../../utils/error.mjs";
+import { listNodeDevices as t } from "./list.mjs";
+//#region src/capabilities/node/device-target.ts
+function n(e) {
+	return (e ?? "").trim().toLowerCase();
+}
+function r(e) {
+	return e.map((e) => ({
+		deviceId: e.deviceId,
+		...e.deviceName ? { deviceName: e.deviceName } : {},
+		online: e.online
+	}));
+}
+async function i(i) {
+	let a;
+	try {
+		a = (await t()).devices;
+	} catch (t) {
+		return {
+			ok: !1,
+			reason: "list_failed",
+			message: e(t)
+		};
+	}
+	let o = i.trim().toLowerCase(), s = a.filter((e) => n(e.deviceName).length > 0), c = s.filter((e) => n(e.deviceName) === o);
+	if (c.length === 1) return {
+		ok: !0,
+		device: c[0]
+	};
+	if (c.length > 1) return {
+		ok: !1,
+		reason: "ambiguous_device_name",
+		candidates: r(c)
+	};
+	let l = s.filter((e) => n(e.deviceName).includes(o));
+	return l.length === 1 ? {
+		ok: !0,
+		device: l[0]
+	} : l.length > 1 ? {
+		ok: !1,
+		reason: "ambiguous_device_name",
+		candidates: r(l)
+	} : {
+		ok: !1,
+		reason: "device_not_found"
+	};
+}
+//#endregion
+export { i as resolveDeviceTargetByName };

package/dist/capabilities/node/index.mjs

@@ -1,4 +1,5 @@
 import "./list.mjs";
+import "./device-target.mjs";
 import "./directory.mjs";
 import "./invoke.mjs";
 import "./types.mjs";

package/dist/cloud-channel/channel.mjs

@@ -9,19 +9,20 @@ import { registerAuthHandler as o } from "./handlers/auth.mjs";
 import { registerContextHandler as s } from "./handlers/context/handler.mjs";
 import "./handlers/context/index.mjs";
 import { registerPairingHandler as c } from "./handlers/pairing.mjs";
-import { registerUserMessageHandler as l } from "./handlers/user-message.mjs";
-import { summarizeServiceEvent as u } from "./log-summary.mjs";
-import { V1Adapter as d } from "./protocol/v1-adapter.mjs";
-import { V2Adapter as f } from "./protocol/v2-adapter.mjs";
+import { registerPushInboundHandler as l } from "./handlers/push-inbound.mjs";
+import { registerUserMessageHandler as u } from "./handlers/user-message.mjs";
+import { summarizeServiceEvent as d } from "./log-summary.mjs";
+import { V1Adapter as f } from "./protocol/v1-adapter.mjs";
+import { V2Adapter as p } from "./protocol/v2-adapter.mjs";
 import "./protocol/index.mjs";
-import { UNEXPECTED_RAW_CODE_SEMANTICS as p } from "./protocol/semantics.mjs";
-import { CloudSocket as m } from "./transport/cloud-socket.mjs";
-import { CloudEventBus as h } from "./transport/event-bus.mjs";
-import { MessageHandler as g } from "./transport/message-handler.mjs";
+import { UNEXPECTED_RAW_CODE_SEMANTICS as m } from "./protocol/semantics.mjs";
+import { CloudSocket as h } from "./transport/cloud-socket.mjs";
+import { CloudEventBus as g } from "./transport/event-bus.mjs";
+import { MessageHandler as _ } from "./transport/message-handler.mjs";
 import "./transport/index.mjs";
-import { buildCloudSocketConnectParams as _ } from "./utils.mjs";
+import { buildCloudSocketConnectParams as v } from "./utils.mjs";
 //#region src/cloud-channel/channel.ts
-var v = e("cloud-channel"), y = 3e4, b = "v2", x = class {
+var y = e("cloud-channel"), b = 3e4, x = "v2", S = class {
 	config;
 	cloudSocket;
 	gatewaySessions;
@@ -34,8 +35,8 @@ var v = e("cloud-channel"), y = 3e4, b = "v2", x = class {
 	businessPingTimer = new r("recurring");
 	constructor(e) {
 		this.config = e;
-		let t = new h();
-		this.protocol = e.protocol ?? b, this.context = { accountId: e.accountId }, this.messageHandler = new g(t, this.context), this.adapter = S(this.protocol), this.cloudSocket = new m({
+		let t = new g();
+		this.protocol = e.protocol ?? x, this.context = { accountId: e.accountId }, this.messageHandler = new _(t, this.context), this.adapter = C(this.protocol), this.cloudSocket = new h({
 			loadConnectParams: this.provideConnectParams,
 			onFrame: this.handleCloudFrame,
 			onOpen: this.handleCloudOpen,
@@ -47,78 +48,78 @@ var v = e("cloud-channel"), y = 3e4, b = "v2", x = class {
 		}), this.authorizationRefreshManager = new i({
 			accountId: e.accountId,
 			outbound: this.dispatcher
-		}), this.gatewaySessions = new n(this.dispatcher), c(this.gatewaySessions, t), l(this.gatewaySessions, t), s(this.dispatcher, t), o(this.authorizationRefreshManager, t);
+		}), this.gatewaySessions = new n(this.dispatcher), c(this.gatewaySessions, t), u(this.gatewaySessions, t), s(this.dispatcher, t), o(this.authorizationRefreshManager, t), l(t);
 	}
 	start() {
-		v.info("starting connection"), this.cloudSocket.start();
+		y.info("starting connection"), this.cloudSocket.start();
 	}
 	destroy() {
-		v.info("closing connection"), this.businessPingTimer.stop(), this.authorizationRefreshManager.destroy(), this.gatewaySessions.closeAll(), this.dispatcher.destroy(), this.cloudSocket.stop();
+		y.info("closing connection"), this.businessPingTimer.stop(), this.authorizationRefreshManager.destroy(), this.gatewaySessions.closeAll(), this.dispatcher.destroy(), this.cloudSocket.stop();
 	}
 	getOutboundPort() {
 		return this.dispatcher;
 	}
 	provideConnectParams = async () => {
 		let e = await this.config.credentialProvider();
-		return e ? _(e.token, this.protocol) : null;
+		return e ? v(e.token, this.protocol) : null;
 	};
 	handleCloudOpen = () => {
-		v.info("cloud connection established"), this.businessPingTimer.start(this.sendBusinessPing, y), this.authorizationRefreshManager.start(), this.config.onOpen?.();
+		y.info("cloud connection established"), this.businessPingTimer.start(this.sendBusinessPing, b), this.authorizationRefreshManager.start(), this.config.onOpen?.();
 	};
 	handleCloudClose = () => {
-		v.info("cloud connection closed"), this.businessPingTimer.stop(), this.config.onClose?.();
+		y.info("cloud connection closed"), this.businessPingTimer.stop(), this.config.onClose?.();
 	};
 	sendBusinessPing = async () => {
 		await this.dispatcher.send({
 			to: t("yoyoclawservice"),
 			msgType: "pingMessage",
 			silent: !0
-		}) || v.warn("failed to send pingMessage");
+		}) || y.warn("failed to send pingMessage");
 	};
 	handleCloudFrame = (e) => {
 		let t;
 		try {
 			t = this.adapter.normalize(e);
 		} catch (e) {
-			v.error("protocol adapter failed", e);
+			y.error("protocol adapter failed", e);
 			return;
 		}
 		switch (t.kind) {
 			case "SUCCESS": {
 				let e = t.serviceEvent;
 				if (e.payload.msgType === "pingMessage") {
-					v.debug("ignored inbound pingMessage", u(e));
+					y.debug("ignored inbound pingMessage", d(e));
 					return;
 				}
-				v.debug("normalized cloud message", u(e)), this.dispatcher.consume(e), this.messageHandler.handleCloudMessage(e);
+				y.debug("normalized cloud message", d(e)), this.dispatcher.consume(e), this.messageHandler.handleCloudMessage(e);
 				return;
 			}
 			case "TARGET_OFFLINE":
-				v.info("remote device offline", { session: t.offlineSocketId }), this.gatewaySessions.closeSession(t.offlineSocketId);
+				y.info("remote device offline", { session: t.offlineSocketId }), this.gatewaySessions.closeSession(t.offlineSocketId);
 				return;
 			case "DEVICE_NOT_REGISTERED":
-				v.info("device not registered, notifying connection layer"), this.config.onError?.({ type: "device-not-registered" });
+				y.info("device not registered, notifying connection layer"), this.config.onError?.({ type: "device-not-registered" });
 				return;
 			case "TOKEN_EXPIRED":
-				v.warn("unauthorized by cloud, pausing refresh"), this.authorizationRefreshManager.pauseForUnauthorized();
+				y.warn("unauthorized by cloud, pausing refresh"), this.authorizationRefreshManager.pauseForUnauthorized();
 				return;
 			case "UNEXPECTED": {
-				let e = p[t.rawCode];
-				e ? v.warn(e, { rawCode: t.rawCode }) : v.warn("unexpected message", { rawCode: t.rawCode });
+				let e = m[t.rawCode];
+				e ? y.warn(e, { rawCode: t.rawCode }) : y.warn("unexpected message", { rawCode: t.rawCode });
 				return;
 			}
 			case "INVALID":
-				v.error("failed to parse message", t.error);
+				y.error("failed to parse message", t.error);
 				return;
-			default: v.warn("non-success control code", { kind: t.kind });
+			default: y.warn("non-success control code", { kind: t.kind });
 		}
 	};
 	handleSocketError = (e) => {
-		v.info("cloud socket error, notifying connection layer", { type: e.type }), this.config.onError?.(e);
+		y.info("cloud socket error, notifying connection layer", { type: e.type }), this.config.onError?.(e);
 	};
 };
-function S(e) {
-	return e === "v1" ? new d() : new f();
+function C(e) {
+	return e === "v1" ? new f() : new p();
 }
 //#endregion
-export { x as ClawChannel };
+export { S as ClawChannel };

package/dist/cloud-channel/handlers/context/cron.mjs

@@ -0,0 +1,58 @@
+import { listCronJobsForChat as e, removeCronJob as t } from "../../../capabilities/cron/service.mjs";
+import "../../../capabilities/cron/index.mjs";
+//#region src/cloud-channel/handlers/context/cron.ts
+var n = "cron.list", r = "cron.remove", i = async ({ event: t, accountId: n }) => {
+	let r = t.from.deviceId;
+	if (!r) return {
+		ok: !1,
+		error: "missing from.deviceId",
+		responsePayload: {
+			ok: !1,
+			error: "missing_from_device_id"
+		}
+	};
+	let i = await e(n, r);
+	return i.ok ? {
+		ok: !0,
+		responsePayload: {
+			ok: !0,
+			jobs: i.jobs
+		}
+	} : {
+		ok: !1,
+		error: i.error,
+		responsePayload: {
+			ok: !1,
+			error: i.error
+		}
+	};
+}, a = async ({ payload: e }) => {
+	let n = typeof e?.jobId == "string" ? e.jobId.trim() : "";
+	if (!n) return {
+		ok: !1,
+		error: "missing jobId",
+		responsePayload: {
+			ok: !1,
+			error: "missing_job_id"
+		}
+	};
+	let r = await t(n);
+	return r.ok ? {
+		ok: !0,
+		responsePayload: {
+			ok: !0,
+			jobId: n,
+			removed: r.removed,
+			alreadyAbsent: !r.removed
+		}
+	} : {
+		ok: !1,
+		error: r.error,
+		responsePayload: {
+			ok: !1,
+			error: r.error
+		}
+	};
+};
+//#endregion
+export { n as CRON_LIST_CONTEXT_NAME, r as CRON_REMOVE_CONTEXT_NAME, i as cronListFetchHandler, a as cronRemoveUpdateHandler };