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

package/dist/capabilities/cron/service.mjs

@@ -5,94 +5,165 @@ 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";
+import { sleep as a } from "../../utils/sleep.mjs";
+import { resolveListTimezone as o } from "./timezone.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 });
+var s = t("cron"), c = 50, l = 300, u = 3, d;
+function f(e) {
+	d = e, s.info("cron service handle updated", { available: e !== void 0 });
 }
-function l() {
-	s = void 0;
+function p() {
+	d = void 0;
 }
-async function u(t, r) {
+async function m(t, r) {
 	let i = await n(t, r);
-	if (!i) return a.info("cron list: request device has no chat mapping, empty result", {
+	if (!i) return s.info("cron list: request device has no chat mapping, empty result", {
 		accountId: t,
 		requestDeviceId: r
 	}), {
 		ok: !0,
 		jobs: [],
-		total: 0
+		total: 0,
+		timezone: o()
 	};
-	let c = s;
-	if (!c) return {
+	let a = d;
+	if (!a) return {
 		ok: !1,
 		error: "cron_unavailable"
 	};
 	let l;
 	try {
-		l = await c.list({ includeDisabled: !0 });
+		l = await a.list({ includeDisabled: !0 });
 	} catch (t) {
-		return a.error("cron list failed", t), {
+		return s.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);
+		if (!await b(e, t, i)) continue;
+		let n = x(e);
 		n && u.push(n);
 	}
-	return a.info("cron list for chat", {
+	return s.info("cron list for chat", {
 		accountId: t,
 		requestDeviceId: r,
 		requestChatId: i,
 		total: l.length,
 		owned: u.length,
-		returned: Math.min(u.length, o)
+		returned: Math.min(u.length, c)
 	}), {
 		ok: !0,
-		jobs: u.slice(0, o),
-		total: l.length
+		jobs: u.slice(0, c),
+		total: l.length,
+		timezone: o()
 	};
 }
-async function d(t) {
-	let n = s;
+async function h(t) {
+	let n = d;
 	if (n) try {
 		return (await n.list({ includeDisabled: !1 })).find((e) => e?.id === t);
 	} catch (n) {
-		a.warn("cron job lookup failed", {
+		s.warn("cron job lookup failed", {
 			jobId: t,
 			error: e(n)
 		});
 		return;
 	}
 }
-async function f(t) {
-	let n = s;
-	if (!n) return {
+async function g(e) {
+	let t = d;
+	if (!t) return {
 		ok: !1,
 		error: "cron_unavailable"
 	};
+	let n = Date.now(), r = _(t, e).catch(() => void 0), i = v(t, e), a = await Promise.race([i.then((e) => e ? "polling" : "polling-exhausted"), r.then(() => "remove")]);
+	if (a === "remove") {
+		let t = await r, i = Date.now() - n;
+		return t === void 0 ? (s.warn("cron remove unresolved: upstream result absent", {
+			jobId: e,
+			elapsedMs: i
+		}), {
+			ok: !1,
+			error: "cron remove failed"
+		}) : (s.debug("cron remove settled by upstream result", {
+			jobId: e,
+			elapsedMs: i,
+			ok: t.ok,
+			removed: t.ok ? t.removed : void 0
+		}), t);
+	}
+	return r.then((t) => {
+		s.info("cron remove late upstream outcome after returning", {
+			jobId: e,
+			winner: a,
+			ok: t?.ok,
+			removed: t?.ok ? t.removed : void 0
+		});
+	}), a === "polling" ? (s.info("cron remove confirmed by store polling, skipping cleanup wait", {
+		jobId: e,
+		elapsedMs: Date.now() - n
+	}), {
+		ok: !0,
+		removed: !0
+	}) : (s.warn("cron remove polling exhausted, returning without cleanup wait", {
+		jobId: e,
+		elapsedMs: Date.now() - n
+	}), {
+		ok: !0,
+		removed: !1
+	});
+}
+async function _(t, n) {
 	try {
 		return {
 			ok: !0,
-			removed: (await n.remove(t))?.removed === !0
+			removed: (await t.remove(n))?.removed === !0
 		};
-	} catch (n) {
-		return a.error("cron remove failed", n, { jobId: t }), {
+	} catch (r) {
+		return await y(t, n) === !1 ? (s.warn("cron remove errored but job no longer exists, treated as success", {
+			jobId: n,
+			error: e(r)
+		}), {
+			ok: !0,
+			removed: !1
+		}) : (s.error("cron remove failed", r, { jobId: n }), {
 			ok: !1,
-			error: e(n)
-		};
+			error: e(r)
+		});
+	}
+}
+async function v(e, t) {
+	for (let n = 1; n <= u; n++) {
+		await a(l);
+		let r = await y(e, t);
+		if (s.debug("cron remove polling probe", {
+			jobId: t,
+			attempt: n,
+			present: r
+		}), r === !1) return !0;
+	}
+	return !1;
+}
+async function y(t, n) {
+	try {
+		return (await t.list({ includeDisabled: !0 })).some((e) => e?.id === n);
+	} catch (t) {
+		s.warn("cron job presence lookup failed", {
+			jobId: n,
+			error: e(t)
+		});
+		return;
 	}
 }
-async function p(e, t, n) {
+async function b(e, t, n) {
 	let i = e.delivery?.to;
 	return typeof i != "string" || i.length === 0 ? !1 : await r(i, t) === n;
 }
-function m(e) {
+function x(e) {
 	if (e.enabled !== !0) return;
-	let t = h(e.schedule);
+	let t = S(e.schedule);
 	if (!t) return;
 	let n = e.state, r = n?.lastRunAtMs;
 	if (r != null) {
@@ -105,11 +176,11 @@ function m(e) {
 		...e.description ? { description: e.description } : {},
 		schedule: t,
 		nextRunAtMs: n?.nextRunAtMs ?? null,
-		...n?.lastRunStatus === void 0 ? {} : { lastRunStatus: g(n.lastRunStatus) },
+		...n?.lastRunStatus === void 0 ? {} : { lastRunStatus: C(n.lastRunStatus) },
 		...r === void 0 ? {} : { lastRunAtMs: r }
 	};
 }
-function h(e) {
+function S(e) {
 	switch (e?.kind) {
 		case "cron": return {
 			kind: "cron",
@@ -129,7 +200,7 @@ function h(e) {
 		default: return;
 	}
 }
-function g(e) {
+function C(e) {
 	switch (e) {
 		case "ok": return i.Success;
 		case "error": return i.Failed;
@@ -137,4 +208,4 @@ function g(e) {
 	}
 }
 //#endregion
-export { c as captureCronService, d as findCronJobById, u as listCronJobsForChat, l as releaseCronService, f as removeCronJob };
+export { f as captureCronService, h as findCronJobById, m as listCronJobsForChat, p as releaseCronService, g as removeCronJob };

package/dist/capabilities/cron/timezone.mjs

@@ -0,0 +1,16 @@
+import { getRuntimeConfig as e } from "openclaw/plugin-sdk/config-runtime";
+//#region src/capabilities/cron/timezone.ts
+function t() {
+	let t = e().agents?.defaults?.userTimezone, r = typeof t == "string" ? t.trim() : "";
+	return n(r) ? r : Intl.DateTimeFormat().resolvedOptions().timeZone?.trim() || "UTC";
+}
+function n(e) {
+	if (!e) return !1;
+	try {
+		return new Intl.DateTimeFormat("en-US", { timeZone: e }).format(/* @__PURE__ */ new Date()), !0;
+	} catch {
+		return !1;
+	}
+}
+//#endregion
+export { t as resolveListTimezone };

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

@@ -16,7 +16,8 @@ var n = "cron.list", r = "cron.remove", i = async ({ event: t, accountId: n }) =
 		ok: !0,
 		responsePayload: {
 			ok: !0,
-			jobs: i.jobs
+			jobs: i.jobs,
+			timezone: i.timezone
 		}
 	} : {
 		ok: !1,

package/dist/command/mock/handler.mjs

@@ -51,6 +51,7 @@ function m(e, t) {
 		`  请求方：account=\`${t.accountId}\` deviceId=\`${t.deviceId}\``,
 		`  归属过滤键：\`chat:${t.chatId}\`（delivery.to 归一后等于该 chatId 的任务才返回）`,
 		`  任务统计：网关共 ${e.total} 条，归属当前会话 ${e.jobs.length} 条`,
+		`  展示时区：\`${e.timezone}\`（at/every 墙钟换算）`,
 		""
 	];
 	return e.jobs.length === 0 ? (n.push(e.total > 0 ? `（当前会话无归属任务；网关另有 ${e.total} 条任务，其 delivery.to 未指向 \`chat:${t.chatId}\`）` : "（网关无任何任务）", "", "验证提示：端侧任务列表应同样为空"), n.join("\n")) : (n.push("| # | 名称 | jobId | 调度 | 下次执行 | 上次执行 |", "| --- | --- | --- | --- | --- | --- |", ...e.jobs.map((e, t) => p(t + 1, e)), "", "&nbsp;", "", "验证提示：", "- 端侧任务列表应与上表一致（列即端侧 DTO 投影，无 delivery 等内部字段）", "- 删除验证：`/yoyo mock cron remove <jobId>` 后重新执行本命令，对应任务应消失"), n.join("\n"));

package/dist/core/prompt/builder.mjs

@@ -2,27 +2,29 @@ import { resolveAgentPromptContribution as e } from "./agent.mjs";
 import { resolveCloudToolPromptContribution as t } from "./cloud-tool.mjs";
 import { resolveCronDeliveryPromptContribution as n } from "./cron.mjs";
 import { resolveLocationPromptContribution as r } from "./location.mjs";
-import { resolveSkillPromptContribution as i } from "./skill.mjs";
+import { resolveCronSkillFallbackContribution as i } from "./skill-fallback.mjs";
+import { resolveSkillPromptContribution as a } from "./skill.mjs";
 //#region src/core/prompt/builder.ts
-function a(e) {
+function o(e) {
 	let t = e.filter((e) => !!e);
 	return t.length > 0 ? t.join("\n\n") : void 0;
 }
-function o(e) {
-	let t = a(e.map((e) => e.prependSystemContext)), n = a(e.map((e) => e.prependContext));
+function s(e) {
+	let t = o(e.map((e) => e.prependSystemContext)), n = o(e.map((e) => e.prependContext));
 	return {
 		...t ? { prependSystemContext: t } : {},
 		...n ? { prependContext: n } : {}
 	};
 }
-async function s(a) {
-	return o([
+async function c(o) {
+	return s([
 		t(),
 		e(),
-		n(a),
-		await i(),
+		n(o),
+		await a(),
+		await i(o),
 		r()
 	]);
 }
 //#endregion
-export { s as resolvePromptBuildContribution };
+export { c as resolvePromptBuildContribution };

package/dist/core/prompt/cron.mjs

@@ -1,19 +1,32 @@
-import "../../consts.mjs";
-import { looksLikeChatId as e } from "../../messaging/target/chat-id.mjs";
-import { readChatIdFromSessionKey as t } from "../../messaging/target/address.mjs";
+import { clawLogger as e } from "../../utils/claw-logger.mjs";
+import { looksLikeChatId as t } from "../../messaging/target/chat-id.mjs";
+import { readChatIdFromSessionKey as n } from "../../messaging/target/address.mjs";
 import "../../messaging/target/index.mjs";
 //#region src/core/prompt/cron.ts
-function n(t) {
-	return t.chatId && e(t.chatId) ? t.chatId : void 0;
+var r = e("cron");
+function i(e) {
+	return e.chatId && t(e.chatId) ? e.chatId : void 0;
 }
-function r(e) {
-	if (!e || t(e.sessionKey)) return {};
-	let r = e.channel === "yoyo" ? n(e) : void 0;
-	return r ? { prependSystemContext: `## 定时任务投递目标
+function a(e) {
+	let t = e ? n(e.sessionKey) : void 0, a = t || (e ? i(e) : void 0);
+	return !e || !a ? (r.debug("cron delivery prompt skipped: no resolvable chatId", {
+		sessionKey: e?.sessionKey ?? null,
+		turnChatId: e?.chatId ?? null
+	}), {}) : (r.info("cron delivery prompt injected", {
+		sessionKey: e.sessionKey ?? null,
+		chatId: a,
+		source: t ? "sessionKey" : "turn"
+	}), { prependSystemContext: `# 定时任务投递目标
+当前对话来自 YOYO 手机侧会话（chatId: ${a}），在本会话中创建定时任务时：
+- 创建方式优先使用 automations 或 cron 工具；两者都不可用时再考虑使用 openclaw cron 命令行，尽量不要使用 subagent。
+- 无论用哪种方式创建，delivery 必须完整包含以下三个字段，缺一不可：
+  {mode:"announce", channel:"yoyo", to:"chat:${a}"}
+- 特别注意 to 字段必须显式写为 "chat:${a}"。即使工具或命令行看起来能自动推断投递目标，也不省略 to —— 缺少 to 的任务执行结果无法推送回本会话。
+- 当用户显式指定投递给其他手机、设备或者 channel 时，可以不按当前规则处理，to 也可以为目标设备对应的 device:{deviceId}
 
-当前对话来自 YOYO 手机侧会话（chatId: ${r}）。在本会话中创建定时任务时：
-- 创建方式优先使用 automations 或 cron 工具；两者都不可用时再使用 openclaw cron 命令行。
-- 无论用哪种方式创建，delivery 必须配置为 {mode:"announce", channel:"yoyo", to:"chat:${r}"}，确保任务执行结果能自动推送回本会话对应的手机侧。` } : {};
+# 定时任务处理策略
+- 严格聚焦当前用户请求：对上下文中已触发过的定时任务及其结果，未经用户明确要求（如"总结一下""结果怎么样"）不主动总结、复述或汇报。
+- 不刻意隐式总结前序定时任务：不用"顺带提醒""补充说明"等方式带出用户未问及的历史任务；任务结果由任务自身投递，无需对话轮次代述。` });
 }
 //#endregion
-export { r as resolveCronDeliveryPromptContribution };
+export { a as resolveCronDeliveryPromptContribution };

package/dist/core/prompt/skill-fallback.mjs

@@ -0,0 +1,34 @@
+import { clawLogger as e } from "../../utils/claw-logger.mjs";
+import { loadYoyoSkillCatalog as t } from "../../provisioning/toolset/skill-catalog.mjs";
+//#region src/core/prompt/skill-fallback.ts
+var n = e("hooks"), r = new Set(["yoyo-update"]);
+async function i(e) {
+	if (!e || e.trigger !== "cron" || e.channel !== "yoyo") return n.debug("cron skill fallback skipped: not a yoyo cron turn", {
+		trigger: e?.trigger ?? null,
+		channel: e?.channel ?? null
+	}), {};
+	let i = (await t())?.filter((e) => !r.has(e.name)) ?? [];
+	return i.length === 0 ? (n.warn("cron skill fallback skipped: empty skill catalog"), {}) : (n.info("cron skill fallback prompt injected", {
+		sessionKey: e.sessionKey ?? null,
+		skillCount: i.length
+	}), { prependSystemContext: a(i) });
+}
+function a(e) {
+	return `# 定时任务技能目录
+当前会话由定时任务触发，系统提示词中可能缺少技能目录。以下是 YOYO 插件自带技能，使用规则与常规会话一致：
+- 先扫描 <available_skills>：与当前任务明确匹配的技能，用 read 工具按 <location> 的绝对路径读取 SKILL.md 全文，并严格遵守其内容执行；没有匹配则不读取。
+- 多个匹配时只选最贴切的一个，最多预读一个；禁止编造路径。
+- 技能正文引用相对路径时，以 SKILL.md 所在目录为基准解析为绝对路径后再调用工具。
+
+<available_skills>
+${e.map((e) => {
+		let t = ["  <skill>", `    <name>${o(e.name)}</name>`];
+		return e.description && t.push(`    <description>${o(e.description)}</description>`), t.push(`    <location>${o(e.location)}</location>`, "  </skill>"), t.join("\n");
+	}).join("\n")}
+</available_skills>`;
+}
+function o(e) {
+	return e.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+}
+//#endregion
+export { i as resolveCronSkillFallbackContribution };

package/dist/messaging/inbound/context.mjs

@@ -66,7 +66,10 @@ function p(t) {
 			rawBody: n.content,
 			commandBody: n.content
 		},
-		access: { commands: { authorized: !0 } },
+		access: {
+			commands: { authorized: !0 },
+			toolPolicy: { deny: ["ask_user", "secrets"] }
+		},
 		messageId: n.messageId,
 		...n.resources.length > 0 ? { media: n.resources.map((e) => ({ url: e.url })) } : {},
 		extra: { OwnerAllowFrom: [n.accountId, n.senderId] }

package/dist/modules/configs/plugin-init.mjs

@@ -30,19 +30,23 @@ async function p(e) {
 			count: Object.keys(M).length,
 			mapping: Object.entries(M).map(([e, t]) => `${e} -> ${t}`).join(", ")
 		});
-		let P = c(t), F = P.changed;
-		if (!g && !_ && !O && !j && !N && !F && !y) return;
-		let I = { ...t.plugins };
-		g && delete I.allow;
-		let L = {
+		let P = c(t), F = P.changed, I = t.plugins?.entries?.[e]?.hooks?.allowConversationAccess !== !0;
+		if (!g && !_ && !O && !j && !N && !F && !y && !I) return;
+		let L = { ...t.plugins };
+		g && delete L.allow;
+		let R = {
 			...t,
 			plugins: {
-				...I,
+				...L,
 				entries: {
 					...t.plugins?.entries,
 					[e]: {
 						...t.plugins?.entries?.[e],
 						enabled: !0,
+						...I ? { hooks: {
+							...t.plugins?.entries?.[e]?.hooks,
+							allowConversationAccess: !0
+						} } : {},
 						config: A
 					}
 				}
@@ -52,11 +56,11 @@ async function p(e) {
 				alsoAllow: b
 			} } : {}
 		};
-		F && (L = {
-			...L,
+		F && (R = {
+			...R,
 			agents: P.agents
-		}, d.info("refreshed agents.defaults values", { changes: P.changes.join(", ") })), _ && (L = {
-			...L,
+		}, d.info("refreshed agents.defaults values", { changes: P.changes.join(", ") })), _ && (R = {
+			...R,
 			skills: {
 				...r,
 				load: {
@@ -64,7 +68,7 @@ async function p(e) {
 					watch: !1
 				}
 			}
-		}, d.info("disabled skills.load.watch for plugin")), N && (L = u(L, M), d.info("provider renaming completed")), await a(L);
+		}, d.info("disabled skills.load.watch for plugin")), N && (R = u(R, M), d.info("provider renaming completed")), await a(R);
 	} catch (e) {
 		throw t(e, "failed to initialize plugin config");
 	}

package/dist/provisioning/toolset/index.mjs

@@ -3,3 +3,4 @@ import "./normalize.mjs";
 import "./processor.mjs";
 import "./ack.mjs";
 import "./cleanup.mjs";
+import "./skill-catalog.mjs";

package/dist/provisioning/toolset/skill-catalog.mjs

@@ -0,0 +1,61 @@
+import { clawLogger as e } from "../../utils/claw-logger.mjs";
+import { normalizeString as t } from "../../utils/normalize.mjs";
+import { resolveExtensionRoot as n } from "../../utils/home-dir.mjs";
+import r from "node:path";
+import i from "node:fs/promises";
+import { parseDocument as a } from "yaml";
+//#region src/provisioning/toolset/skill-catalog.ts
+var o = e("toolset"), s = "skills", c = "SKILL.md", l;
+async function u() {
+	if (l) return l;
+	try {
+		l = await d();
+	} catch (e) {
+		o.warn("skill catalog scan failed", { error: String(e) });
+		return;
+	}
+	return l;
+}
+async function d() {
+	let e = r.join(n(), s), t = await i.readdir(e, { withFileTypes: !0 }), a = [];
+	for (let n of t) {
+		if (!n.isDirectory()) continue;
+		let t = r.join(e, n.name, c), i = await f(t);
+		if (!i) {
+			o.warn("skill catalog entry skipped: missing or incomplete frontmatter", { skillPath: t });
+			continue;
+		}
+		a.push({
+			...i,
+			location: t
+		});
+	}
+	return a.sort((e, t) => e.name.localeCompare(t.name)), a;
+}
+async function f(e) {
+	let t;
+	try {
+		t = await i.readFile(e, "utf8");
+	} catch {
+		return;
+	}
+	return p(t);
+}
+function p(e) {
+	let n = /^---\r?\n([\s\S]*?)\r?\n---/.exec(e);
+	if (!n) return;
+	let r = a(n[1], {
+		schema: "core",
+		prettyErrors: !1
+	});
+	if (r.errors.length > 0) return;
+	let i = r.toJS();
+	if (typeof i != "object" || !i) return;
+	let o = i, s = t(o.name) || void 0, c = t(o.description) || void 0;
+	return s && c ? {
+		name: s,
+		description: c
+	} : void 0;
+}
+//#endregion
+export { u as loadYoyoSkillCatalog };

package/dist/utils/sleep.mjs

@@ -0,0 +1,6 @@
+//#region src/utils/sleep.ts
+function e(e) {
+	return new Promise((t) => setTimeout(t, e));
+}
+//#endregion
+export { e as sleep };

package/openclaw.plugin.json

@@ -4,7 +4,8 @@
   "skills": ["./skills"],
   "enabledByDefault": true,
   "activation": {
-    "onStartup": true
+    "onStartup": true,
+    "onCapabilities": ["hook"]
   },
   "contracts": {
     "tools": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@honor-claw/yoyo",
-  "version": "2026.9.3-alpha.2",
+  "version": "2026.9.4-alpha.1",
   "description": "OpenClaw Honor Yoyo connection plugin",
   "keywords": [
     "ai",
@@ -12,6 +12,7 @@
   "files": [
     "dist",
     "skills",
+    "!skills/yoyo-phone-control/mcptools",
     "openclaw.plugin.json"
   ],
   "type": "module",
@@ -48,6 +49,7 @@
     "undici": "^7.3.0",
     "winreg": "^1.2.5",
     "ws": "^8.18.0",
+    "yaml": "^2.9.0",
     "zod": "^4.3.6"
   },
   "devDependencies": {