@xgjktech/xg-openclaw-harness-tools 0.3.1 → 0.3.3

package/dist/action-dispatch-tool.d.ts

@@ -0,0 +1,15 @@
+import { Type, type Static } from "typebox";
+import type { AnyAgentTool } from "openclaw/plugin-sdk/plugin-entry";
+import { type ActionStore, type PlanOrigin } from "@xgjktech/xg-openclaw-shared";
+export declare const ActionDispatchParams: Type.TObject<{
+    action: Type.TUnion<[Type.TLiteral<"ui_refresh">, Type.TLiteral<"notification">, Type.TLiteral<"workflow_trigger">, Type.TLiteral<"form_fill">, Type.TString]>;
+    target: Type.TString;
+    topic: Type.TOptional<Type.TString>;
+    status: Type.TOptional<Type.TUnion<[Type.TLiteral<"completed">, Type.TLiteral<"running">, Type.TLiteral<"pending">, Type.TLiteral<"failed">]>>;
+    activeSessionOnly: Type.TOptional<Type.TBoolean>;
+    payloadData: Type.TRecord<"^.*$", Type.TUnknown>;
+}>;
+export type ActionDispatchParamsT = Static<typeof ActionDispatchParams>;
+export declare const ACTION_DISPATCH_DESCRIPTION: string;
+export declare function buildActionDispatchTool(store: ActionStore, origin?: PlanOrigin): AnyAgentTool;
+//# sourceMappingURL=action-dispatch-tool.d.ts.map

package/dist/action-dispatch-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-dispatch-tool.d.ts","sourceRoot":"","sources":["../src/action-dispatch-tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,UAAU,EAChB,MAAM,8BAA8B,CAAC;AAGtC,eAAO,MAAM,oBAAoB;;;;;;;EA+ChC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE,eAAO,MAAM,2BAA2B,QAS5B,CAAC;AAMb,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,YAAY,CA0D7F"}

package/dist/action-dispatch-tool.js

@@ -0,0 +1,96 @@
+import { randomUUID } from "node:crypto";
+import { Type } from "typebox";
+import { assertActionDispatchEventInvariants, } from "@xgjktech/xg-openclaw-shared";
+import { toolJsonResult } from "./tool-json-result.js";
+export const ActionDispatchParams = Type.Object({
+    action: Type.Union([
+        Type.Literal("ui_refresh"),
+        Type.Literal("notification"),
+        Type.Literal("workflow_trigger"),
+        Type.Literal("form_fill"),
+        Type.String({ description: "自定义扩展动作类型" }),
+    ], { description: "指令动作大类" }),
+    target: Type.String({
+        minLength: 1,
+        maxLength: 128,
+        description: "目标组件或页面标识 (必须严格等于前端注册的 target 标识，如 order_detail_panel)",
+    }),
+    topic: Type.Optional(Type.String({
+        maxLength: 64,
+        description: "业务主题/模块标识 (如 order_management, user_system)",
+    })),
+    status: Type.Optional(Type.Union([
+        Type.Literal("completed"),
+        Type.Literal("running"),
+        Type.Literal("pending"),
+        Type.Literal("failed"),
+    ], { default: "completed", description: "动作生命周期状态" })),
+    activeSessionOnly: Type.Optional(Type.Boolean({ default: true, description: "是否限制仅在当前激活前端窗口生效" })),
+    payloadData: Type.Record(Type.String(), Type.Unknown(), {
+        description: "传递给前端的具体业务数据键值对 (格式为 { data: { ... } })",
+    }),
+}, { additionalProperties: false });
+export const ACTION_DISPATCH_DESCRIPTION = [
+    "用途：分发通用动作指令（如 UI 局部刷新 ui_refresh、通知 notification、工作流触发 workflow_trigger、表单填充 form_fill 等）给前端客户端消费。",
+    "",
+    "参数要求：",
+    "- action: 动作类型枚举 (ui_refresh, notification, workflow_trigger, form_fill 或自定义扩展动作)。",
+    "- target: 目标组件或页面标识 (如 order_detail_panel)。",
+    "- payloadData: 包含要传递给前端业务数据的键值字典。",
+    "- activeSessionOnly: 默认为 true，限制仅在活跃前端窗口生效。",
+    "- status: 默认为 completed，异步长任务可用 running/pending/failed 表达状态变化。",
+].join("\n");
+export function buildActionDispatchTool(store, origin) {
+    return {
+        name: "xg_action_dispatch",
+        label: "【xg-harness】动作指令分发",
+        description: ACTION_DISPATCH_DESCRIPTION,
+        parameters: ActionDispatchParams,
+        async execute(_toolCallId, rawParams) {
+            const params = rawParams;
+            try {
+                const eventId = `evt_${randomUUID()}`;
+                const now = new Date();
+                const version = now.getTime();
+                const status = params.status ?? "completed";
+                const event = {
+                    eventId,
+                    event: "action_dispatch",
+                    action: params.action,
+                    target: params.target,
+                    version,
+                    status,
+                    scopeControl: {
+                        activeSessionOnly: params.activeSessionOnly ?? true,
+                    },
+                    payload: {
+                        data: params.payloadData,
+                    },
+                    timestamp: now.toISOString(),
+                };
+                if (params.topic !== undefined && params.topic.trim() !== "") {
+                    event.topic = params.topic;
+                }
+                if (origin !== undefined) {
+                    event.origin = origin;
+                }
+                assertActionDispatchEventInvariants(event);
+                store.set(event);
+                const result = {
+                    ok: true,
+                    eventId: event.eventId,
+                    version: event.version,
+                    event,
+                };
+                return toolJsonResult(result);
+            }
+            catch (e) {
+                const result = {
+                    ok: false,
+                    error: { code: "ACTION_DISPATCH_ERROR", detail: String(e.message) },
+                };
+                return toolJsonResult(result);
+            }
+        },
+    };
+}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAYA,wBAoCG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAiBA,wBAqDG"}

package/dist/index.js

@@ -1,23 +1,30 @@
 import { defineToolPlugin } from "openclaw/plugin-sdk/tool-plugin";
-import { resolvePlanDbPath, SqlitePlanStore } from "@xgjktech/xg-openclaw-shared";
+import { resolvePlanDbPath, SqlitePlanStore, SqliteActionStore } from "@xgjktech/xg-openclaw-shared";
 import { PLAN_WRITE_DESCRIPTION, PlanWriteParams, buildPlanWriteTool } from "./plan-write-tool.js";
 import { PLAN_EXECUTE_DESCRIPTION, PlanExecuteParams, buildPlanExecuteTool, } from "./plan-execute-tool.js";
+import { ACTION_DISPATCH_DESCRIPTION, ActionDispatchParams, buildActionDispatchTool, } from "./action-dispatch-tool.js";
 import { toPlanOrigin } from "./plan-origin.js";
 const PLUGIN_ID = "xg-harness-tools";
 export default defineToolPlugin({
     id: PLUGIN_ID,
     name: "XG Harness Tools",
-    description: "企业工具插件：计划编写与查看（plan_write / plan_execute）",
+    description: "企业工具插件：计划管理与通用动作分发（plan_write / plan_execute / action_dispatch）",
     tools: (tool) => {
-        // store 单例：defineToolPlugin 的 tools(...) 只在插件加载时调用一次，
-        // 闭包在此建一次即可；factory 本身会在每次 agent attempt 重建工具集时重新调用。
-        let store;
-        const getStore = (api) => {
-            if (store === undefined) {
+        let planStore;
+        let actionStore;
+        const getPlanStore = (api) => {
+            if (planStore === undefined) {
                 const dbPath = resolvePlanDbPath(api.runtime.state.resolveStateDir());
-                store = new SqlitePlanStore(dbPath);
+                planStore = new SqlitePlanStore(dbPath);
             }
-            return store;
+            return planStore;
+        };
+        const getActionStore = (api) => {
+            if (actionStore === undefined) {
+                const dbPath = resolvePlanDbPath(api.runtime.state.resolveStateDir());
+                actionStore = new SqliteActionStore(dbPath);
+            }
+            return actionStore;
         };
         return [
             tool({
@@ -26,7 +33,7 @@ export default defineToolPlugin({
                 description: PLAN_WRITE_DESCRIPTION,
                 parameters: PlanWriteParams,
                 optional: true,
-                factory: ({ api, toolContext }) => buildPlanWriteTool(getStore(api), toPlanOrigin(toolContext)),
+                factory: ({ api, toolContext }) => buildPlanWriteTool(getPlanStore(api), toPlanOrigin(toolContext)),
             }),
             tool({
                 name: "xg_plan_execute",
@@ -34,7 +41,15 @@ export default defineToolPlugin({
                 description: PLAN_EXECUTE_DESCRIPTION,
                 parameters: PlanExecuteParams,
                 optional: true,
-                factory: ({ api, toolContext }) => buildPlanExecuteTool({ store: getStore(api), origin: toPlanOrigin(toolContext) }),
+                factory: ({ api, toolContext }) => buildPlanExecuteTool({ store: getPlanStore(api), origin: toPlanOrigin(toolContext) }),
+            }),
+            tool({
+                name: "xg_action_dispatch",
+                label: "【xg-harness】动作指令分发",
+                description: ACTION_DISPATCH_DESCRIPTION,
+                parameters: ActionDispatchParams,
+                optional: true,
+                factory: ({ api, toolContext }) => buildActionDispatchTool(getActionStore(api), toPlanOrigin(toolContext)),
             }),
         ];
     },

package/dist/plan-execute-tool.d.ts

@@ -1,6 +1,6 @@
 import { Type, type Static } from "typebox";
 import type { AnyAgentTool } from "openclaw/plugin-sdk/plugin-entry";
-import type { PlanOrigin, PlanStore } from "@xgjktech/xg-openclaw-shared";
+import { type PlanOrigin, type PlanStore } from "@xgjktech/xg-openclaw-shared";
 export declare const PlanExecuteParams: Type.TObject<{
     planId: Type.TOptional<Type.TString>;
 }>;

package/dist/plan-execute-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan-execute-tool.d.ts","sourceRoot":"","sources":["../src/plan-execute-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAAQ,UAAU,EAAE,SAAS,EAAe,MAAM,8BAA8B,CAAC;AAK7F,eAAO,MAAM,iBAAiB;;EAK7B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,eAAO,MAAM,wBAAwB,QAQzB,CAAC;AAuBb,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,UAAU,CAAA;CAAE,GAAG,YAAY,CA2ClG"}
+{"version":3,"file":"plan-execute-tool.d.ts","sourceRoot":"","sources":["../src/plan-execute-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,SAAS,EAEf,MAAM,8BAA8B,CAAC;AAKtC,eAAO,MAAM,iBAAiB;;EAK7B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,eAAO,MAAM,wBAAwB,QAQzB,CAAC;AAuBb,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,UAAU,CAAA;CAAE,GAAG,YAAY,CA+ClG"}

package/dist/plan-execute-tool.js

@@ -1,4 +1,5 @@
 import { Type } from "typebox";
+import { isPlanCancelled, } from "@xgjktech/xg-openclaw-shared";
 import { renderPlanView } from "./plan-view.js";
 import { planInScope, scopeKey } from "./plan-scope.js";
 import { toolJsonResult } from "./tool-json-result.js";
@@ -46,7 +47,11 @@ export function buildPlanExecuteTool(deps) {
                 if (params.planId === undefined) {
                     const plans = scope === undefined
                         ? []
-                        : store.listPlansByOrigin(scope).slice(0, 10).map(summarizePlan);
+                        : store
+                            .listPlansByOrigin(scope)
+                            .filter((plan) => !isPlanCancelled(plan))
+                            .slice(0, 10)
+                            .map(summarizePlan);
                     const result = { ok: true, plans };
                     return toolJsonResult(result);
                 }

package/dist/plan-view.d.ts

@@ -1,3 +1,3 @@
-import type { Plan } from "@xgjktech/xg-openclaw-shared";
+import { type Plan } from "@xgjktech/xg-openclaw-shared";
 export declare function renderPlanView(plan: Plan): string;
 //# sourceMappingURL=plan-view.d.ts.map

package/dist/plan-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan-view.d.ts","sourceRoot":"","sources":["../src/plan-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAA0B,MAAM,8BAA8B,CAAC;AAoBjF,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAejD"}
+{"version":3,"file":"plan-view.d.ts","sourceRoot":"","sources":["../src/plan-view.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,IAAI,EAGV,MAAM,8BAA8B,CAAC;AAoBtC,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAgBjD"}

package/dist/plan-view.js

@@ -1,3 +1,4 @@
+import { isPlanCancelled, } from "@xgjktech/xg-openclaw-shared";
 const TASK_STATUS_MARKERS = {
     pending: "[ ]",
     in_progress: "[>]",
@@ -14,7 +15,8 @@ function singleLine(text) {
     return text.replace(/\s*\r?\n\s*/g, " ");
 }
 export function renderPlanView(plan) {
-    const lines = [`goal: ${singleLine(plan.goal)}`];
+    const cancelledMarker = isPlanCancelled(plan) ? "【已取消】" : "";
+    const lines = [`goal: ${cancelledMarker}${singleLine(plan.goal)}`];
     plan.tasks.forEach((task, taskIndex) => {
         const note = task.note !== undefined ? ` | note: ${singleLine(task.note)}` : "";
         lines.push(`T${taskIndex} ${TASK_STATUS_MARKERS[task.status]} ${singleLine(task.title)}${note}`);

package/dist/plan-write-tool.d.ts

@@ -3,12 +3,13 @@ import type { AnyAgentTool } from "openclaw/plugin-sdk/plugin-entry";
 import { type PlanOrigin, type PlanStore } from "@xgjktech/xg-openclaw-shared";
 export declare const PlanWriteParams: Type.TObject<{
     planId: Type.TOptional<Type.TString>;
-    goal: Type.TString;
-    tasks: Type.TArray<Type.TObject<{
+    goal: Type.TOptional<Type.TString>;
+    tasks: Type.TOptional<Type.TArray<Type.TObject<{
         title: Type.TString;
         status: Type.TOptional<Type.TUnion<[Type.TLiteral<"pending">, Type.TLiteral<"in_progress">, Type.TLiteral<"completed">, Type.TLiteral<"blocked">]>>;
         note: Type.TOptional<Type.TString>;
-    }>>;
+    }>>>;
+    cancel: Type.TOptional<Type.TBoolean>;
 }>;
 export type PlanWriteParamsT = Static<typeof PlanWriteParams>;
 export declare const PLAN_WRITE_DESCRIPTION: string;

package/dist/plan-write-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan-write-tool.d.ts","sourceRoot":"","sources":["../src/plan-write-tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,SAAS,EAGf,MAAM,8BAA8B,CAAC;AA4BtC,eAAO,MAAM,eAAe;;;;;;;;EAiB3B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,sBAAsB,QAkBvB,CAAC;AAwCb,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,YAAY,CA6CtF"}
+{"version":3,"file":"plan-write-tool.d.ts","sourceRoot":"","sources":["../src/plan-write-tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,SAAS,EAGf,MAAM,8BAA8B,CAAC;AA8BtC,eAAO,MAAM,eAAe;;;;;;;;;EAwB3B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,sBAAsB,QAmBvB,CAAC;AA0Eb,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,YAAY,CAsHtF"}

package/dist/plan-write-tool.js

@@ -1,6 +1,6 @@
 import { randomUUID } from "node:crypto";
 import { Type } from "typebox";
-import { assertPlanInvariants, } from "@xgjktech/xg-openclaw-shared";
+import { assertPlanInvariants, isPlanCancelled, } from "@xgjktech/xg-openclaw-shared";
 import { toolJsonResult } from "./tool-json-result.js";
 import { renderPlanView } from "./plan-view.js";
 import { planInScope, scopeKey } from "./plan-scope.js";
@@ -20,16 +20,17 @@ const TaskInput = Type.Object({
 }, { additionalProperties: false });
 export const PlanWriteParams = Type.Object({
     planId: Type.Optional(Type.String({ maxLength: 128, description: "留空=新建；填写=整张覆盖该计划" })),
-    goal: Type.String({
+    goal: Type.Optional(Type.String({
         minLength: 1,
         maxLength: 500,
         description: "计划总目标，一句话说明完成态",
-    }),
-    tasks: Type.Array(TaskInput, {
+    })),
+    tasks: Type.Optional(Type.Array(TaskInput, {
         minItems: 1,
         maxItems: 20,
         description: "完整任务清单；更新时未提交的旧任务会被删除",
-    }),
+    })),
+    cancel: Type.Optional(Type.Boolean({ description: "取消该计划；true 时只需带 planId，不带 goal/tasks" })),
 }, { additionalProperties: false });
 export const PLAN_WRITE_DESCRIPTION = [
     "用途：维护一份对用户可见、可跨回合保存的任务清单。每次调用都是整张替换，不是增量更新。",
@@ -46,9 +47,10 @@ export const PLAN_WRITE_DESCRIPTION = [
     "",
     "提交规则：",
     "- 新建时不传 planId；更新时传入原 planId。",
-    "- 更新时必须重新提交 goal 和所有要保留的 tasks，包括未变化任务及其当前 status/note。只提交变化项会删除其他任务；记不清时先用 xg_plan_execute 查看。",
+    "- 更新计划内容时必须重新提交 goal 和所有要保留的 tasks，包括未变化任务及其当前 status/note。只提交变化项会删除其他任务；记不清时先用 xg_plan_execute 查看。",
     "- goal 用一句话；tasks 通常 3-7 项，每项是能判断是否完成的具体动作，不写 TODO、待定或内部思考。",
     "- status 为 pending、in_progress、completed 或 blocked。通常只有一项 in_progress，确实并行时可以有多项；blocked 时必须用 note 写明原因和继续所需条件。",
+    "- 同一件工作只维护一份计划；任务方向变化时，先取消不再推进的旧计划（{planId, cancel:true}）再新建。",
 ].join("\n");
 function toTask(input) {
     const task = {
@@ -60,14 +62,13 @@ function toTask(input) {
     }
     return task;
 }
-function buildPlan(params, existing, planId, origin) {
-    const now = new Date().toISOString();
+function buildPlan(goal, tasks, existing, planId, origin, now) {
     const plan = {
         planId,
-        goal: params.goal,
+        goal,
         createdAt: existing?.createdAt ?? now,
         updatedAt: now,
-        tasks: params.tasks.map(toTask),
+        tasks: tasks.map(toTask),
     };
     // 改写已有计划时保留原 origin（改写是内容编辑，不是重新发起）。
     // 无 origin 的旧计划已在作用域校验阶段被拒绝，不会在这里被认领。
@@ -77,6 +78,34 @@ function buildPlan(params, existing, planId, origin) {
     }
     return plan;
 }
+function compactText(text) {
+    return text.replace(/\s*\r?\n\s*/g, " ");
+}
+function relativeTime(updatedAt, nowMs) {
+    const updatedAtMs = Date.parse(updatedAt);
+    if (!Number.isFinite(updatedAtMs))
+        return "时间未知";
+    const elapsedMs = Math.max(0, nowMs - updatedAtMs);
+    const minutes = Math.floor(elapsedMs / 60_000);
+    if (minutes < 1)
+        return "刚刚";
+    if (minutes < 60)
+        return `${minutes} 分钟前`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24)
+        return `${hours} 小时前`;
+    return `${Math.floor(hours / 24)} 天前`;
+}
+function unfinishedPlanWarning(plans, nowMs) {
+    const unfinished = plans.filter((plan) => !isPlanCancelled(plan) && plan.tasks.some((task) => task.status !== "completed"));
+    if (unfinished.length === 0)
+        return undefined;
+    const details = unfinished.slice(0, 3).map((plan) => {
+        const completed = plan.tasks.filter((task) => task.status === "completed").length;
+        return `${plan.planId} «${compactText(plan.goal)}»(${completed}/${plan.tasks.length}，最后更新 ${relativeTime(plan.updatedAt, nowMs)})`;
+    });
+    return `本会话还有 ${unfinished.length} 份未完成计划：${details.join("；")}。若已不再推进，请用 {planId, cancel:true} 取消，避免面板残留。`;
+}
 export function buildPlanWriteTool(store, origin) {
     const scope = scopeKey(origin);
     return {
@@ -87,6 +116,57 @@ export function buildPlanWriteTool(store, origin) {
         async execute(_toolCallId, rawParams) {
             const params = rawParams;
             try {
+                if (params.cancel === true) {
+                    if (params.planId === undefined ||
+                        params.goal !== undefined ||
+                        params.tasks !== undefined) {
+                        const result = {
+                            ok: false,
+                            error: { code: "CANCEL_FIELDS_CONFLICT" },
+                        };
+                        return toolJsonResult(result);
+                    }
+                    const existing = store.get(params.planId);
+                    if (existing === undefined || !planInScope(existing, scope)) {
+                        const result = {
+                            ok: false,
+                            error: { code: "PLAN_NOT_FOUND" },
+                        };
+                        return toolJsonResult(result);
+                    }
+                    if (isPlanCancelled(existing)) {
+                        const result = {
+                            ok: true,
+                            planId: existing.planId,
+                            cancelled: true,
+                            view: renderPlanView(existing),
+                        };
+                        return toolJsonResult(result);
+                    }
+                    const now = new Date().toISOString();
+                    const cancelledPlan = {
+                        ...existing,
+                        status: "cancelled",
+                        cancelledAt: now,
+                        updatedAt: now,
+                    };
+                    assertPlanInvariants(cancelledPlan);
+                    store.set(cancelledPlan);
+                    const result = {
+                        ok: true,
+                        planId: cancelledPlan.planId,
+                        cancelled: true,
+                        view: renderPlanView(cancelledPlan),
+                    };
+                    return toolJsonResult(result);
+                }
+                if (params.goal === undefined || params.tasks === undefined) {
+                    const result = {
+                        ok: false,
+                        error: { code: "WRITE_FIELDS_REQUIRED" },
+                    };
+                    return toolJsonResult(result);
+                }
                 let existing;
                 if (params.planId !== undefined) {
                     existing = store.get(params.planId);
@@ -98,14 +178,21 @@ export function buildPlanWriteTool(store, origin) {
                         return toolJsonResult(result);
                     }
                 }
+                let warnings;
+                if (params.planId === undefined && scope !== undefined) {
+                    const warning = unfinishedPlanWarning(store.listPlansByOrigin(scope), Date.now());
+                    if (warning !== undefined)
+                        warnings = [warning];
+                }
                 const planId = params.planId ?? randomUUID();
-                const plan = buildPlan(params, existing, planId, origin);
+                const plan = buildPlan(params.goal, params.tasks, existing, planId, origin, new Date().toISOString());
                 assertPlanInvariants(plan);
                 store.set(plan);
                 const result = {
                     ok: true,
                     planId: plan.planId,
                     view: renderPlanView(plan),
+                    ...(warnings !== undefined ? { warnings } : {}),
                 };
                 return toolJsonResult(result);
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xgjktech/xg-openclaw-harness-tools",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "企业工具插件：plan_write / plan_execute 计划工具（OpenClaw 第三方工具插件）",
   "license": "MIT",
   "type": "module",
@@ -27,7 +27,7 @@
   },
   "dependencies": {
     "typebox": "1.1.39",
-    "@xgjktech/xg-openclaw-shared": "^0.2.1"
+    "@xgjktech/xg-openclaw-shared": "^0.2.2"
   },
   "devDependencies": {
     "@types/node": "^22.19.0",
@@ -52,4 +52,4 @@
       "defaultChoice": "local"
     }
   }
-}
+}