@xgjktech/xg-openclaw-shared 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export type { Plan, Task, Step, TaskStatus, StepStatus } from "./plan-types.js";
+export type { Plan, Task, Step, TaskStatus, StepStatus, PlanOrigin } from "./plan-types.js";
 export { assertPlanInvariants, PlanInvariantError } from "./plan-types.js";
 export type { PlanStore, PlanSummary } from "./plan-store.js";
 export { SqlitePlanStore, openPlanStoreReadonly, resolvePlanDbPath, PlanStoreError } from "./plan-store.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE3E,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE5G,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC5F,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE3E,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE5G,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/plan-store.d.ts

@@ -15,6 +15,10 @@ export interface PlanStore {
     set(plan: Plan): void;
     delete(planId: string): void;
     list(): PlanSummary[];
+    listPlansByOrigin(origin: {
+        channel: string;
+        to: string;
+    }): Plan[];
 }
 export declare class PlanStoreError extends Error {
     constructor(message: string, options?: {
@@ -34,12 +38,16 @@ export declare class SqlitePlanStore implements PlanStore {
     set(plan: Plan): void;
     delete(planId: string): void;
     list(): PlanSummary[];
+    listPlansByOrigin(origin: {
+        channel: string;
+        to: string;
+    }): Plan[];
 }
 /**
  * IM 侧只读入口：以 readOnly 模式打开同一 DB，杜绝误写。
- * 只暴露 get/list（缝隙 C 读路径），不暴露 set/delete。
+ * 只暴露 get/list/listPlansByOrigin（缝隙 C 读路径），不暴露 set/delete。
  */
-export declare function openPlanStoreReadonly(dbPath: string): Pick<PlanStore, "get" | "list">;
+export declare function openPlanStoreReadonly(dbPath: string): Pick<PlanStore, "get" | "list" | "listPlansByOrigin">;
 /**
  * 路径约定：<stateDir>/xgjktech/plans.sqlite（两插件共享 xgjktech 命名空间）。
  * 负责 mkdir -p 该子目录，调用方无需自行建目录。

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

@@ -1 +1 @@
-{"version":3,"file":"plan-store.d.ts","sourceRoot":"","sources":["../src/plan-store.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CACvF;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACtC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,IAAI,WAAW,EAAE,CAAC;CACvB;AAED,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI3D;AAyGD;;;GAGG;AACH,qBAAa,eAAgB,YAAW,SAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAe;gBAEtB,MAAM,EAAE,MAAM;IAI1B,kDAAkD;IAClD,KAAK,IAAI,IAAI;IAIb,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIrC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IA8BrB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ5B,IAAI,IAAI,WAAW,EAAE;CAGtB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC,CAWrF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAI1D"}
+{"version":3,"file":"plan-store.d.ts","sourceRoot":"","sources":["../src/plan-store.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CACvF;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACtC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,IAAI,WAAW,EAAE,CAAC;IACtB,iBAAiB,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,EAAE,CAAC;CACpE;AAED,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI3D;AA0JD;;;GAGG;AACH,qBAAa,eAAgB,YAAW,SAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAe;gBAEtB,MAAM,EAAE,MAAM;IAI1B,kDAAkD;IAClD,KAAK,IAAI,IAAI;IAIb,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIrC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAkCrB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ5B,IAAI,IAAI,WAAW,EAAE;IAIrB,iBAAiB,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,EAAE;CAGnE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,GACb,IAAI,CAAC,SAAS,EAAE,KAAK,GAAG,MAAM,GAAG,mBAAmB,CAAC,CAoBvD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAI1D"}

package/dist/plan-store.js

@@ -9,7 +9,7 @@ export class PlanStoreError extends Error {
         this.name = "PlanStoreError";
     }
 }
-const SCHEMA_VERSION = 1;
+const SCHEMA_VERSION = 2;
 const BUSY_TIMEOUT_MS = 5000;
 const CREATE_TABLE_SQL = `
 CREATE TABLE IF NOT EXISTS plans (
@@ -20,9 +20,16 @@ CREATE TABLE IF NOT EXISTS plans (
   doc         TEXT NOT NULL
 ) STRICT;
 `;
-const CREATE_INDEX_SQL = `
+const CREATE_INDEX_UPDATED_AT_SQL = `
 CREATE INDEX IF NOT EXISTS idx_plans_updated_at ON plans(updated_at);
 `;
+const CREATE_INDEX_ORIGIN_SQL = `
+CREATE INDEX IF NOT EXISTS idx_plans_origin ON plans(origin_channel, origin_to);
+`;
+function listColumnNames(db) {
+    const rows = db.prepare("PRAGMA table_info(plans);").all();
+    return new Set(rows.map((row) => row.name));
+}
 function parsePlanDoc(row) {
     try {
         return JSON.parse(row.doc);
@@ -46,7 +53,15 @@ function summarizeTaskCounts(plan) {
 }
 function ensureSchema(db) {
     db.exec(CREATE_TABLE_SQL);
-    db.exec(CREATE_INDEX_SQL);
+    const columns = listColumnNames(db);
+    if (!columns.has("origin_channel")) {
+        db.exec("ALTER TABLE plans ADD COLUMN origin_channel TEXT;");
+    }
+    if (!columns.has("origin_to")) {
+        db.exec("ALTER TABLE plans ADD COLUMN origin_to TEXT;");
+    }
+    db.exec(CREATE_INDEX_UPDATED_AT_SQL);
+    db.exec(CREATE_INDEX_ORIGIN_SQL);
     db.exec(`PRAGMA user_version = ${SCHEMA_VERSION};`);
 }
 function openDatabase(dbPath, options) {
@@ -73,6 +88,13 @@ function readAllPlanRows(db) {
         .prepare("SELECT plan_id, goal, created_at, updated_at, doc FROM plans ORDER BY updated_at DESC")
         .all();
 }
+function readPlanRowsByOrigin(db, origin) {
+    return db
+        .prepare(`SELECT plan_id, goal, created_at, updated_at, doc FROM plans
+       WHERE origin_channel = ? AND origin_to = ?
+       ORDER BY updated_at DESC`)
+        .all(origin.channel, origin.to);
+}
 function getPlan(db, planId, errorPrefix) {
     try {
         const row = readPlanRow(db, planId);
@@ -102,6 +124,16 @@ function listPlans(db, errorPrefix) {
         throw new PlanStoreError(`${errorPrefix} plan 列表失败`, { cause });
     }
 }
+function listPlansByOrigin(db, origin, errorPrefix) {
+    try {
+        return readPlanRowsByOrigin(db, origin).map((row) => parsePlanDoc(row));
+    }
+    catch (cause) {
+        if (cause instanceof PlanStoreError)
+            throw cause;
+        throw new PlanStoreError(`${errorPrefix} plan 按 origin 列表失败`, { cause });
+    }
+}
 /**
  * SqlitePlanStore：本插件的唯一写者。读写走事务，异常一律转 PlanStoreError，
  * 绝不让底层 SQLite 异常冒泡崩 gateway（企业工具与 gateway 同进程约束）。
@@ -123,18 +155,22 @@ export class SqlitePlanStore {
             this.db.exec("BEGIN IMMEDIATE");
             try {
                 this.db
-                    .prepare(`INSERT INTO plans (plan_id, goal, created_at, updated_at, doc)
-             VALUES (@planId, @goal, @createdAt, @updatedAt, @doc)
+                    .prepare(`INSERT INTO plans (plan_id, goal, created_at, updated_at, doc, origin_channel, origin_to)
+             VALUES (@planId, @goal, @createdAt, @updatedAt, @doc, @originChannel, @originTo)
              ON CONFLICT(plan_id) DO UPDATE SET
                goal = excluded.goal,
                updated_at = excluded.updated_at,
-               doc = excluded.doc`)
+               doc = excluded.doc,
+               origin_channel = excluded.origin_channel,
+               origin_to = excluded.origin_to`)
                     .run({
                     planId: plan.planId,
                     goal: plan.goal,
                     createdAt: plan.createdAt,
                     updatedAt: plan.updatedAt,
                     doc: JSON.stringify(plan),
+                    originChannel: plan.origin?.channel ?? null,
+                    originTo: plan.origin?.to ?? null,
                 });
                 this.db.exec("COMMIT");
             }
@@ -158,10 +194,13 @@ export class SqlitePlanStore {
     list() {
         return listPlans(this.db, "列出");
     }
+    listPlansByOrigin(origin) {
+        return listPlansByOrigin(this.db, origin, "列出");
+    }
 }
 /**
  * IM 侧只读入口：以 readOnly 模式打开同一 DB，杜绝误写。
- * 只暴露 get/list（缝隙 C 读路径），不暴露 set/delete。
+ * 只暴露 get/list/listPlansByOrigin（缝隙 C 读路径），不暴露 set/delete。
  */
 export function openPlanStoreReadonly(dbPath) {
     const db = openDatabase(dbPath, { readOnly: true });
@@ -172,6 +211,15 @@ export function openPlanStoreReadonly(dbPath) {
         list() {
             return listPlans(db, "只读列出");
         },
+        listPlansByOrigin(origin) {
+            // 只读连接无写权限、不能 ALTER 补齐旧库缺失的 origin 列；每次调用现探测，
+            // 缺列时静默降级为 []，绝不缓存该结论——writer 后续迁移后需能立即恢复可见。
+            const columns = listColumnNames(db);
+            if (!columns.has("origin_channel") || !columns.has("origin_to")) {
+                return [];
+            }
+            return listPlansByOrigin(db, origin, "只读列出");
+        },
     };
 }
 /**

package/dist/plan-types.d.ts

@@ -10,12 +10,30 @@ export interface Task {
     note?: string;
     steps?: Step[];
 }
+/**
+ * 计划的来源会话上下文。由调用方（工具插件）从工具工厂 ctx 采集后随 plan 落库，
+ * 供跨进程/跨重启把计划路由回原会话（IM 侧据此推送计划状态事件）。
+ * 全字段可选：采集不到就省略，绝不因缺字段阻断计划本身的落盘。
+ */
+export interface PlanOrigin {
+    /** 通道 id，IM 插件为 "xg_cwork_im" */
+    channel?: string;
+    /** 通道内目标 id，IM 插件为 groupId */
+    to?: string;
+    /** 通道账户 id（多账户部署下区分机器人身份） */
+    accountId?: string;
+    /** thread/topic id；上游可能是 number，此处统一归一为 string */
+    threadId?: string;
+    /** 会话 key。诊断与未来关联用，不参与路由 */
+    sessionKey?: string;
+}
 export interface Plan {
     planId: string;
     goal: string;
     createdAt: string;
     updatedAt: string;
     tasks: Task[];
+    origin?: PlanOrigin;
 }
 export declare class PlanInvariantError extends Error {
     constructor(message: string);

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

@@ -1 +1 @@
-{"version":3,"file":"plan-types.d.ts","sourceRoot":"","sources":["../src/plan-types.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC;AAC7E,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC;AAUjE,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,IAAI;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,IAAI;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAED,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAUD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAwDrD"}
+{"version":3,"file":"plan-types.d.ts","sourceRoot":"","sources":["../src/plan-types.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC;AAC7E,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC;AAUjE,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,IAAI;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,IAAI;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAUD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAwDrD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xgjktech/xg-openclaw-shared",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "xgjktech OpenClaw 插件共享层：Plan 数据模型/不变量、SQLite PlanStore、计划事件契约",
   "license": "MIT",
   "type": "module",