pactive 0.0.3-alpha.1 → 0.0.4-alpha.1

package/dsh/index.js

@@ -65,12 +65,20 @@ async function markControlReturned(ctx) {
   }
 }
 
-const STATUS_PARAMETERS = { type: "object", properties: {}, additionalProperties: false };
+const STATUS_PARAMETERS = {
+  type: "object",
+  properties: { assistant: { type: "string", description: "只读：助理名或 id；不传 = 全部助理概览" } },
+  additionalProperties: false,
+};
+const ASSISTANTS_PARAMETERS = { type: "object", properties: {}, additionalProperties: false };
+const FLEET_PARAMETERS = { type: "object", properties: {}, additionalProperties: false };
 const CONFIG_PARAMETERS = {
   type: "object",
   properties: {
-    key: { type: "string", description: "配置键；缺省返回全部（idle.enabled / idle.thresholdMs / policy.*）" },
+    key: { type: "string", description: "配置键；缺省返回全部（idle.enabled / idle.thresholdMs / policy.* / globalGuard.hourlyLimit）" },
     value: { type: "string", description: "想改成的新值；给了就只返回 `pactive config set <key> <value> --confirm`，不落盘" },
+    kind: { type: "string", description: "提议哪种写操作：assistant.add | assistant.remove | assistant.enable（只返回命令，不落盘）" },
+    name: { type: "string", description: "kind=assistant.* 时要操作的助理名或 id（缺 id 时用名字）" },
   },
   additionalProperties: false,
 };
@@ -79,11 +87,60 @@ const SCHEDULE_PARAMETERS = {
   properties: {
     prompt: { type: "string", description: "任务正文（到点注入给会话的内容）" },
     when: { type: "string", description: "触发时间：时长（10m）/ 时刻（18:30）/ ISO 8601 / every 1h" },
+    assistant: { type: "string", description: "记在哪个助理名下（名字或 id）；不传 = 默认助理" },
   },
   required: ["prompt"],
   additionalProperties: false,
 };
 
+/** One assistant as the model needs to see it: switch, pending work, next action. */
+function assistantView(core, state, record) {
+  const all = core.schedule?.list ? core.schedule.list(state, record.assistantId) : [];
+  const active = (Array.isArray(all) ? all : []).filter((t) => t && t.active !== false);
+  const dueAt = active.map((t) => t.dueAt).filter((n) => Number.isFinite(n));
+  return {
+    assistantId: record.assistantId,
+    name: record.name,
+    title: record.title,
+    enabled: record.enabled === true,
+    role: record.role ?? "",
+    tasks: active.length,
+    nextDueAt: dueAt.length > 0 ? Math.min(...dueAt) : null,
+    lastFiredAt: record.lastFiredAt ?? 0,
+    firedCount: record.firedCount ?? 0,
+    policy: record.policy ?? {},
+  };
+}
+
+function assistantOverview(core, state) {
+  const list = core.assistants?.list ? core.assistants.list(state) : [];
+  return list.map((record) => assistantView(core, state, record));
+}
+
+/**
+ * I66: the model only *proposes* — every assistant write comes back as one copy-pasteable
+ * command whose `--confirm` a human has to type. Nothing here writes.
+ */
+function assistCommandFor(kind, name, value, fleet) {
+  const known = fleet.map((a) => a.name);
+  if (kind === "assistant.add") {
+    if (name === "") return { ok: false, reason: "kind=assistant.add 需要 name" };
+    if (known.includes(name)) return { ok: false, reason: `助理已经存在（${name}），已有：${known.join(", ")}` };
+    return { ok: true, command: `pactive assistant add ${name} --confirm` };
+  }
+  if (kind === "assistant.remove" || kind === "assistant.enable") {
+    if (name === "") return { ok: false, reason: `kind=${kind} 需要 name` };
+    const hit = fleet.find((a) => a.name === name || a.assistantId === name);
+    if (!hit) return { ok: false, reason: `未知助理（${name}）；已有：${known.join(", ") || "(none yet)"}` };
+    if (kind === "assistant.enable") {
+      const on = value === "" ? !hit.enabled : value === "true" || value === "1" || value === "on";
+      return { ok: true, command: `pactive assistant ${on ? "enable" : "disable"} ${hit.name} --confirm` };
+    }
+    return { ok: true, command: `pactive assistant rm ${hit.name} --confirm` };
+  }
+  return { ok: false, reason: `未知 kind（${kind}）；支持 assistant.add / assistant.remove / assistant.enable` };
+}
+
 /**
  * @param {any} ctx Cordis plugin context
  * @param {Record<string, any>} config
@@ -97,8 +154,8 @@ export function apply(ctx, config) {
     ctx.tools.register({
       name: "pactive_status",
       description:
-        "当用户问「我现在闲不闲」「主动提醒开启了吗」「为什么没触发」「刚才主动做了什么」时用。" +
-        "→ 读当前空闲判定、reason、护栏四闸门、任务数与最近活动。只读，不落盘。",
+        "当用户问「我现在闲不闲」「主动提醒开启了吗」「为什么没触发」「刚才主动做了什么」「盯盘那个助理怎么样了」时用。" +
+        "→ 读空闲判定、reason、护栏闸门与任务数；给 assistant 看该助理，不给看全部助理概览。只读，不落盘。",
       parameters: STATUS_PARAMETERS,
       async execute(args = {}) {
         try {
@@ -106,19 +163,48 @@ export function apply(ctx, config) {
           const now = Date.now();
           const paths = core.resolvePaths(HOST_KIND, process.env);
           const state = (await readState(core, paths)) ?? core.defaultState();
+          const globalGuard = state.globalGuard ?? null;
+          const activity = core.getActivity ? core.getActivity(state) : null;
+          const requested = typeof args.assistant === "string" ? args.assistant.trim() : "";
+          if (requested !== "") {
+            const record = core.assistants?.resolve ? core.assistants.resolve(state, requested) : null;
+            if (!record) {
+              const names = assistantOverview(core, state).map((a) => a.name);
+              return { ok: false, error: `未知助理（${requested}）；已知：${names.join(", ") || "(none yet)"}` };
+            }
+            const idle = core.evaluateIdle
+              ? core.evaluateIdle(state, now, {}, record.assistantId)
+              : { idle: false, reason: "requires-action" };
+            const guard = core.checkGuard
+              ? core.checkGuard(state, now, record.assistantId)
+              : { pass: false, reason: "requires-action" };
+            return {
+              ok: true,
+              host: HOST_KIND,
+              now,
+              assistant: assistantView(core, state, record),
+              idle,
+              guard,
+              globalGuard,
+              activity,
+            };
+          }
           const idle = core.evaluateIdle
             ? core.evaluateIdle(state, now, state.policy ?? {})
             : { idle: false, reason: "requires-action" };
           const guard = core.checkGuard ? core.checkGuard(state, now) : { pass: false, reason: "requires-action" };
           const tasks = core.schedule?.list ? core.schedule.list(state) : (state.tasks ?? []);
-          const activity = core.getActivity ? core.getActivity(state) : null;
+          const fleet = assistantOverview(core, state);
           return {
             ok: true,
             host: HOST_KIND,
             now,
             enabled: state.idle?.enabled ?? false,
+            assistants: fleet,
+            assistantCount: fleet.length,
             idle,
             guard,
+            globalGuard,
             tasks: Array.isArray(tasks) ? tasks.length : 0,
             activity,
           };
@@ -128,11 +214,49 @@ export function apply(ctx, config) {
       },
     });
 
+    ctx.tools.register({
+      name: "pactive_assistants",
+      description:
+        "当用户问「我有几个助理」「有哪些助理」「盯盘助理开着吗」「各自下次什么时候动作」时用。" +
+        "→ 列出全部助理的名称、开关、任务数、下次到期与触发次数。只读，不落盘。",
+      parameters: ASSISTANTS_PARAMETERS,
+      async execute() {
+        try {
+          const core = await loadCore();
+          const paths = core.resolvePaths(HOST_KIND, process.env);
+          const state = (await readState(core, paths)) ?? core.defaultState();
+          const fleet = assistantOverview(core, state);
+          return { ok: true, count: fleet.length, assistants: fleet };
+        } catch (err) {
+          return { ok: false, error: errorText(err) };
+        }
+      },
+    });
+
+    ctx.tools.register({
+      name: "pactive_fleet",
+      description:
+        "当用户问「我有几个助理在跑」「盯盘那个助理在哪个 pane」「助理的窗口还活着吗」「上次主动投递送达了吗」时用。" +
+        "→ 读助理 ↔ herdr pane 绑定、agent 状态与最近一次投递；pane 状态来自 herdr，未观测到就写 unobserved。只读，不落盘。",
+      parameters: FLEET_PARAMETERS,
+      async execute() {
+        try {
+          const core = await loadCore();
+          const fleetView = await import("../src/hosts/herdr/fleet-view.mjs");
+          const paths = core.resolvePaths(HOST_KIND, process.env);
+          const state = (await readState(core, paths)) ?? core.defaultState();
+          return { ...fleetView.fleetPayload(core, state, paths, process.env) };
+        } catch (err) {
+          return { ok: false, error: errorText(err) };
+        }
+      },
+    });
+
     ctx.tools.register({
       name: "pactive_schedule",
       description:
         "当用户说「10 分钟后提醒我喝水」「18:30 提醒我开会」「每小时检查一次」时用。" +
-        "→ 登记一条定时任务并立即落盘；when 支持 10m / 18:30 / ISO 8601 / every 1h。" +
+        "→ 登记一条定时任务并立即落盘；when 支持 10m / 18:30 / ISO 8601 / every 1h；assistant 不填就记在默认助理名下。" +
         "会写盘，需要人工确认（只在用户明确要求时调用）。",
       parameters: SCHEDULE_PARAMETERS,
       async execute(args = {}) {
@@ -144,19 +268,33 @@ export function apply(ctx, config) {
           if (!spec) return { ok: false, error: `无法解析 when：${String(args.when)}` };
           const core = await loadCore();
           const paths = core.resolvePaths(HOST_KIND, process.env);
+          const requested = typeof args.assistant === "string" ? args.assistant.trim() : "";
+          let assistantId = null;
+          if (requested !== "") {
+            const before = (await readState(core, paths)) ?? core.defaultState();
+            const record = core.assistants?.resolve ? core.assistants.resolve(before, requested) : null;
+            if (!record) {
+              const names = assistantOverview(core, before).map((a) => a.name);
+              return { ok: false, error: `未知助理（${requested}）；已知：${names.join(", ") || "(none yet)"}` };
+            }
+            assistantId = record.assistantId;
+          }
           const next = await mutateState(core, paths, (state) => {
+            const targetId =
+              assistantId ?? (core.assistants?.ensureDefault ? core.assistants.ensureDefault(state).assistantId : null);
             const out = core.schedule.add(
               state,
-              { ...spec, prompt, content: prompt, owner: state.identity?.agentId },
+              { ...spec, prompt, content: prompt, owner: state.identity?.agentId, assistantId: targetId },
               now,
             );
             return pickState(out, state);
           });
-          const tasks = core.schedule?.list ? core.schedule.list(next) : (next.tasks ?? []);
+          const tasks = core.schedule?.list ? core.schedule.list(next, assistantId ?? undefined) : (next.tasks ?? []);
           const created = Array.isArray(tasks) ? tasks[tasks.length - 1] : null;
           return {
             ok: true,
             taskId: created?.id ?? created?.taskId ?? null,
+            assistantId: created?.assistantId ?? assistantId,
             dueAt: created?.dueAt ?? spec.at ?? null,
             kind: spec.kind,
             when: spec.when,
@@ -168,12 +306,12 @@ export function apply(ctx, config) {
       },
     });
 
-    // Read-only by construction: a write request returns the command, never a write (contract §2.3).
+    // Read-only by construction: a write request returns the command, never a write (contract §2.3 / I66).
     ctx.tools.register({
       name: "pactive_config",
       description:
-        "当用户问「主动提醒的开关开着吗」「阈值是多少」「安静时间是几点」「帮我把主动提醒打开」时用。" +
-        "→ 读配置值与默认值；要改配置时只返回一条需要人工确认的可复制命令。只读，不落盘。",
+        "当用户问「主动提醒的开关开着吗」「阈值是多少」「安静时间是几点」「帮我把主动提醒打开」「再给我加一个盯盘的助理」时用。" +
+        "→ 读配置值与默认值；要改配置或增删 / 开关助理时，只返回一条需要人工确认的可复制命令。只读，不落盘。",
       parameters: CONFIG_PARAMETERS,
       async execute(args = {}) {
         try {
@@ -182,18 +320,36 @@ export function apply(ctx, config) {
           const known = Object.keys(described.defaults);
           const key = typeof args.key === "string" ? args.key.trim() : "";
           const rawValue = args.value === undefined || args.value === null ? "" : String(args.value).trim();
+          const kind = typeof args.kind === "string" ? args.kind.trim() : "";
+          const name = typeof args.name === "string" ? args.name.trim() : "";
+          const paths = core.resolvePaths(HOST_KIND, process.env);
+          const state = (await readState(core, paths)) ?? core.defaultState();
+          const fleet = assistantOverview(core, state);
+
+          if (kind !== "") {
+            const command = assistCommandFor(kind, name, rawValue, fleet);
+            if (!command.ok) return { ok: false, error: command.reason };
+            return {
+              ok: false,
+              wrote: false,
+              reason: "need_human_confirmation",
+              command: command.command,
+              kind,
+              before: { assistants: fleet.length, names: fleet.map((a) => a.name) },
+              hint: "不要自己改状态文件；把 command 原样给用户，等他执行后下一轮用 pactive_assistants 复核。",
+            };
+          }
+
           if (key !== "" && !known.includes(key)) {
             return { ok: false, error: `未知配置键（${key}）；已知：${known.join(", ")}` };
           }
-          const paths = core.resolvePaths(HOST_KIND, process.env);
-          const state = (await readState(core, paths)) ?? core.defaultState();
           const values = (key === "" ? known : [key]).map((k) => ({
             key: k,
             value: core.config?.get ? core.config.get(state, k) : null,
             default: described.defaults[k] ?? null,
             humanGated: described.schema?.[k]?.humanGated === true,
           }));
-          if (rawValue === "") return { ok: true, readOnly: true, wrote: false, values };
+          if (rawValue === "") return { ok: true, readOnly: true, wrote: false, values, assistants: fleet.length };
           return {
             ok: false,
             wrote: false,

package/mcp/tools/definitions.mjs

@@ -1,7 +1,8 @@
 /**
  * MCP tool surface of the `pactive` OPCteam plugin (stdio JSON-RPC server).
  *
- * Tools: pactive_status / pactive_schedule / pactive_tell / pactive_history.
+ * Tools: pactive_status / pactive_assistants / pactive_fleet / pactive_config / pactive_schedule /
+ *        pactive_tell / pactive_history.
  * Zero third-party dependencies — the schemas are plain JSON Schema.
  *
  * unverified: mailbox.send / ledger.tail argument shapes come from the frozen
@@ -35,19 +36,35 @@ export const TOOL_DEFINITIONS = [
   {
     name: "pactive_status",
     description:
-      "当用户问「我现在闲不闲」「主动提醒开启了吗」「为什么没触发」「刚才主动做了什么」时用。" +
-      "→ 读当前空闲判定、reason、护栏四闸门、任务数与最近活动。只读，不落盘。",
+      "当用户问「我现在闲不闲」「主动提醒开启了吗」「为什么没触发」「刚才主动做了什么」「盯盘那个助理怎么样了」时用。" +
+      "→ 读空闲判定、reason、护栏闸门与任务数；给 assistant 看该助理，不给看全部助理概览。只读，不落盘。",
+    inputSchema: obj({ assistant: str("只读：助理名或 id；不传 = 全部助理概览") }, []),
+  },
+  {
+    name: "pactive_assistants",
+    description:
+      "当用户问「我有几个助理」「有哪些助理」「盯盘助理开着吗」「各自下次什么时候动作」时用。" +
+      "→ 列出全部助理的名称、开关、任务数、下次到期与触发次数。只读，不落盘。",
+    inputSchema: obj({}, []),
+  },
+  {
+    name: "pactive_fleet",
+    description:
+      "当用户问「我有几个助理在跑」「盯盘那个助理在哪个 pane」「助理的窗口还活着吗」「上次主动投递送达了吗」时用。" +
+      "→ 读助理 ↔ herdr pane 绑定、agent 状态与最近一次投递；pane 状态来自 herdr，未观测到就写 unobserved。只读，不落盘。",
     inputSchema: obj({}, []),
   },
   {
     name: "pactive_config",
     description:
-      "当用户问「主动提醒的开关开着吗」「阈值是多少」「安静时间是几点」「帮我把主动提醒打开」时用。" +
-      "→ 读配置值与默认值；要改配置时只返回一条需要人工确认的可复制命令。只读，不落盘。",
+      "当用户问「主动提醒的开关开着吗」「阈值是多少」「安静时间是几点」「帮我把主动提醒打开」「再给我加一个盯盘的助理」时用。" +
+      "→ 读配置值与默认值；要改配置或增删 / 开关助理时，只返回一条需要人工确认的可复制命令。只读，不落盘。",
     inputSchema: obj(
       {
-        key: str("配置键；缺省返回全部（idle.enabled / idle.thresholdMs / policy.*）"),
+        key: str("配置键；缺省返回全部（idle.enabled / idle.thresholdMs / policy.* / globalGuard.hourlyLimit）"),
         value: str("想改成的新值；给了就只返回 `pactive config set <key> <value> --confirm`，不落盘"),
+        kind: str("提议哪种写操作：assistant.add | assistant.remove | assistant.enable（只返回命令，不落盘）"),
+        name: str("kind=assistant.* 时要操作的助理名或 id（缺 id 时用名字）"),
       },
       [],
     ),
@@ -56,12 +73,13 @@ export const TOOL_DEFINITIONS = [
     name: "pactive_schedule",
     description:
       "当用户说「10 分钟后提醒我喝水」「18:30 提醒我开会」「每小时检查一次」时用。" +
-      "→ 登记一条定时任务并立即落盘；when 支持 10m / 18:30 / ISO 8601 / every 1h。" +
+      "→ 登记一条定时任务并立即落盘；when 支持 10m / 18:30 / ISO 8601 / every 1h；assistant 不填就记在默认助理名下。" +
       "会写盘，需要人工确认（只在用户明确要求时调用）。",
     inputSchema: obj(
       {
         prompt: str("任务正文（到点注入给会话的内容）"),
         when: str("触发时间：时长 / 时刻 / ISO 8601 / every <时长>；缺省 10m"),
+        assistant: str("记在哪个助理名下（名字或 id）；不传 = 默认助理"),
       },
       ["prompt"],
     ),
@@ -99,6 +117,54 @@ function json(text, isError = false) {
   return { content: [{ type: "text", text: typeof text === "string" ? text : JSON.stringify(text, null, 2) }], isError };
 }
 
+/** One assistant as the model (and the user) needs to see it: switch, pending work, next action. */
+function assistantView(core, state, record) {
+  const all = core.schedule?.list ? core.schedule.list(state, record.assistantId) : [];
+  const active = (Array.isArray(all) ? all : []).filter((t) => t && t.active !== false);
+  const dueAt = active.map((t) => t.dueAt).filter((n) => Number.isFinite(n));
+  return {
+    assistantId: record.assistantId,
+    name: record.name,
+    title: record.title,
+    enabled: record.enabled === true,
+    role: record.role ?? "",
+    tasks: active.length,
+    nextDueAt: dueAt.length > 0 ? Math.min(...dueAt) : null,
+    lastFiredAt: record.lastFiredAt ?? 0,
+    firedCount: record.firedCount ?? 0,
+    policy: record.policy ?? {},
+  };
+}
+
+function assistantOverview(core, state) {
+  const list = core.assistants?.list ? core.assistants.list(state) : [];
+  return list.map((record) => assistantView(core, state, record));
+}
+
+/**
+ * I66: the model only *proposes* — every assistant write comes back as one copy-pasteable
+ * command whose `--confirm` a human has to type. Nothing above writes.
+ */
+function assistCommandFor(kind, name, value, fleet) {
+  const known = fleet.map((a) => a.name);
+  if (kind === "assistant.add") {
+    if (name === "") return { ok: false, reason: "kind=assistant.add 需要 name" };
+    if (known.includes(name)) return { ok: false, reason: `助理已经存在（${name}），已有：${known.join(", ")}` };
+    return { ok: true, command: `pactive assistant add ${name} --confirm` };
+  }
+  if (kind === "assistant.remove" || kind === "assistant.enable") {
+    if (name === "") return { ok: false, reason: `kind=${kind} 需要 name` };
+    const hit = fleet.find((a) => a.name === name || a.assistantId === name);
+    if (!hit) return { ok: false, reason: `未知助理（${name}）；已有：${known.join(", ") || "(none yet)"}` };
+    if (kind === "assistant.enable") {
+      const on = value === "" ? !hit.enabled : value === "true" || value === "1" || value === "on";
+      return { ok: true, command: `pactive assistant ${on ? "enable" : "disable"} ${hit.name} --confirm` };
+    }
+    return { ok: true, command: `pactive assistant rm ${hit.name} --confirm` };
+  }
+  return { ok: false, reason: `未知 kind（${kind}）；支持 assistant.add / assistant.remove / assistant.enable` };
+}
+
 /**
  * Run one tool.
  * @param {string} name
@@ -121,33 +187,94 @@ export async function runTool(name, args = {}, options = {}) {
       case "pactive_status": {
         const state = (await readState(core, paths)) ?? core.defaultState();
         const policy = state.policy ?? {};
+        const globalGuard = state.globalGuard ?? null;
+        const requested = typeof args.assistant === "string" ? args.assistant.trim() : "";
+        if (requested !== "") {
+          const record = core.assistants?.resolve ? core.assistants.resolve(state, requested) : null;
+          if (!record) {
+            const names = core.assistants?.list ? core.assistants.list(state).map((a) => a.name) : [];
+            return json(`ERROR INVALID_ARGUMENT: 未知助理（${requested}）；已知：${names.join(", ") || "(none yet)"}`, true);
+          }
+          const idle = core.evaluateIdle
+            ? core.evaluateIdle(state, now, {}, record.assistantId)
+            : { idle: false, reason: "requires-action" };
+          const guard = core.checkGuard
+            ? core.checkGuard(state, now, record.assistantId)
+            : { pass: false, reason: "requires-action" };
+          return json({
+            host: HOST_KIND,
+            now,
+            assistant: assistantView(core, state, record),
+            idle,
+            guard,
+            globalGuard,
+            activity: core.getActivity ? core.getActivity(state) : null,
+            stateFile: paths.stateFile,
+          });
+        }
         const idle = core.evaluateIdle ? core.evaluateIdle(state, now, policy) : { idle: false, reason: "requires-action" };
         const guard = core.checkGuard ? core.checkGuard(state, now) : { pass: false, reason: "requires-action" };
         const tasks = core.schedule?.list ? core.schedule.list(state) : (state.tasks ?? []);
         const activity = core.getActivity ? core.getActivity(state) : null;
+        const fleet = assistantOverview(core, state);
         return json({
           host: HOST_KIND,
           now,
           enabled: state.idle?.enabled ?? false,
+          assistants: fleet,
+          assistantCount: fleet.length,
           idle,
           guard,
+          globalGuard,
           tasks: Array.isArray(tasks) ? tasks.length : 0,
           activity,
           stateFile: paths.stateFile,
         });
       }
 
+      case "pactive_assistants": {
+        const state = (await readState(core, paths)) ?? core.defaultState();
+        const fleet = assistantOverview(core, state);
+        return json({ ok: true, count: fleet.length, assistants: fleet, stateFile: paths.stateFile });
+      }
+
+      case "pactive_fleet": {
+        const state = (await readState(core, paths)) ?? core.defaultState();
+        const { fleetPayload } = await import("../../src/hosts/herdr/fleet-view.mjs");
+        return json({ ...fleetPayload(core, state, paths, env), stateFile: paths.stateFile });
+      }
+
       case "pactive_config": {
         // Read-only. A write request never lands: the model gets a copy-pasteable command
-        // whose --confirm only a human can type (contract §2.3 / I59).
+        // whose --confirm only a human can type (contract §2.3 / I59 / I66).
         const described = core.config?.describe ? core.config.describe() : { schema: {}, defaults: {}, humanGatedKeys: [] };
         const known = Object.keys(described.defaults);
         const key = typeof args.key === "string" ? args.key.trim() : "";
         const rawValue = args.value === undefined || args.value === null ? "" : String(args.value).trim();
+        const kind = typeof args.kind === "string" ? args.kind.trim() : "";
+        const name = typeof args.name === "string" ? args.name.trim() : "";
+        const state = (await readState(core, paths)) ?? core.defaultState();
+        const fleet = assistantOverview(core, state);
+        const names = fleet.map((a) => a.name);
+
+        if (kind !== "") {
+          const command = assistCommandFor(kind, name, rawValue, fleet);
+          if (!command.ok) return json(`ERROR INVALID_ARGUMENT: ${command.reason}`, true);
+          return json({
+            ok: false,
+            readOnly: false,
+            wrote: false,
+            reason: "need_human_confirmation",
+            command: command.command,
+            kind,
+            before: { assistants: fleet.length, names },
+            hint: "不要自己改状态文件；把 command 原样给用户，等他执行后下一轮用 pactive_assistants 复核。",
+          });
+        }
+
         if (key !== "" && !known.includes(key)) {
           return json(`ERROR INVALID_ARGUMENT: 未知配置键（${key}）；已知：${known.join(", ")}`, true);
         }
-        const state = (await readState(core, paths)) ?? core.defaultState();
         const values = (key === "" ? known : [key]).map((k) => ({
           key: k,
           value: core.config?.get ? core.config.get(state, k) : null,
@@ -155,7 +282,7 @@ export async function runTool(name, args = {}, options = {}) {
           humanGated: described.schema?.[k]?.humanGated === true,
         }));
         if (rawValue === "") {
-          return json({ ok: true, readOnly: true, wrote: false, values, stateFile: paths.stateFile });
+          return json({ ok: true, readOnly: true, wrote: false, values, assistants: fleet.length, stateFile: paths.stateFile });
         }
         return json({
           ok: false,
@@ -173,15 +300,34 @@ export async function runTool(name, args = {}, options = {}) {
         if (prompt === "") return json("ERROR INVALID_ARGUMENT: prompt 必填", true);
         const spec = parseWhen(args.when, now);
         if (!spec) return json(`ERROR INVALID_ARGUMENT: 无法解析 when（${String(args.when)}）`, true);
-const next = await mutateState(core, paths, (state) => {
-          const out = core.schedule.add(state, { ...spec, prompt, content: prompt, owner: state.identity?.agentId }, now);
+        const requested = typeof args.assistant === "string" ? args.assistant.trim() : "";
+        const state0 = (await readState(core, paths)) ?? core.defaultState();
+        let assistantId = null;
+        if (requested !== "") {
+          const record = core.assistants?.resolve ? core.assistants.resolve(state0, requested) : null;
+          if (!record) {
+            const names = assistantOverview(core, state0).map((a) => a.name);
+            return json(`ERROR INVALID_ARGUMENT: 未知助理（${requested}）；已知：${names.join(", ") || "(none yet)"}`, true);
+          }
+          assistantId = record.assistantId;
+        }
+        const next = await mutateState(core, paths, (state) => {
+          const targetId = assistantId ?? (core.assistants?.ensureDefault
+            ? core.assistants.ensureDefault(state).assistantId
+            : null);
+          const out = core.schedule.add(
+            state,
+            { ...spec, prompt, content: prompt, owner: state.identity?.agentId, assistantId: targetId },
+            now,
+          );
           return pickState(out, state);
         });
-        const tasks = core.schedule?.list ? core.schedule.list(next) : (next.tasks ?? []);
+        const tasks = core.schedule?.list ? core.schedule.list(next, assistantId ?? undefined) : (next.tasks ?? []);
         const created = Array.isArray(tasks) ? tasks[tasks.length - 1] : null;
         return json({
           ok: true,
           taskId: created?.id ?? created?.taskId ?? null,
+          assistantId: created?.assistantId ?? assistantId,
           dueAt: created?.dueAt ?? spec.at ?? null,
           kind: spec.kind,
           when: spec.when,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pactive",
-  "version": "0.0.3-alpha.1",
+  "version": "0.0.4-alpha.1",
   "description": "Pactive：跨 Pi / OPCteam / DSH 的主动能力运行时（idle 判定默认关闭、人工闸门、事件账本）。专有软件：使用条款见包内 LICENSE（发行物含 Pi 扩展源码 pi/extension.ts）。",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",