pactive 0.0.2-alpha.1 → 0.0.4-alpha.1

package/commands/pactive.md

@@ -22,6 +22,7 @@ mcp__plugin_pactive_pactive__<tool>
 - `mcp__plugin_pactive_pactive__pactive_schedule`
 - `mcp__plugin_pactive_pactive__pactive_tell`
 - `mcp__plugin_pactive_pactive__pactive_history`
+- `mcp__plugin_pactive_pactive__pactive_config`（只读；要改配置时只返回可复制命令）
 
 裸名（`pactive_status`）不一定能被 ToolSearch 发现；若命名空间工具没加载，用
 `select:mcp__plugin_pactive_pactive__pactive_status` 搜一次。
@@ -36,11 +37,13 @@ mcp__plugin_pactive_pactive__<tool>
 | 每小时 | `pactive_schedule` `when:"every 1h"` |
 | 告诉另一个会话 | `pactive_tell` `to` `body`（可选 `kind:"ask"`） |
 | 最近发生过什么 | `pactive_history` `limit` |
+| 开关 / 阈值 / 安静时间是多少 | `pactive_config` `key`（只读，报当前值与默认值） |
+| 帮我开启主动提醒 / 改阈值 | `pactive_config` `key` `value` → 只拿到 `pactive config set … --confirm`，交给用户执行 |
 
 ## 硬规则
 
 1. **不要替用户改配置**：pactive 的开关与配置是人工闸门（CLI `--confirm`）。用户要求改配置时，
-   告诉他用 `pactive config set … --confirm`，不要自行绕过。
+   告诉他用 `pactive config set … --confirm`，不要自行绕过；用户执行后下一轮用 `pactive_status` 复核。
 2. **回执如实转述**：`queued` 就是**还没送到**（对端离线），不要说成已送达。
 3. **默认不打扰**：空闲触发默认关闭；用户没明确要「空闲自动推进」时，不要假设它已开启。
 4. **只报新事实**：状态类输出要给出 `idle.reason` 与护栏结论，不要泛泛说「一切正常」。

package/dsh/index.js

@@ -65,17 +65,82 @@ 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.* / 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,
+};
 const SCHEDULE_PARAMETERS = {
   type: "object",
   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
@@ -89,7 +154,8 @@ export function apply(ctx, config) {
     ctx.tools.register({
       name: "pactive_status",
       description:
-        "Pactive 主动机制状态：空闲判定与 reason、护栏四闸门、定时任务数、最近活动。只读。",
+        "当用户问「我现在闲不闲」「主动提醒开启了吗」「为什么没触发」「刚才主动做了什么」「盯盘那个助理怎么样了」时用。" +
+        "→ 读空闲判定、reason、护栏闸门与任务数；给 assistant 看该助理，不给看全部助理概览。只读，不落盘。",
       parameters: STATUS_PARAMETERS,
       async execute(args = {}) {
         try {
@@ -97,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,
           };
@@ -119,9 +214,50 @@ 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: "登记一个定时任务（真正落盘）。when 支持时长（10m）、时刻（18:30）、ISO 时间、every 1h。",
+      description:
+        "当用户说「10 分钟后提醒我喝水」「18:30 提醒我开会」「每小时检查一次」时用。" +
+        "→ 登记一条定时任务并立即落盘；when 支持 10m / 18:30 / ISO 8601 / every 1h；assistant 不填就记在默认助理名下。" +
+        "会写盘，需要人工确认（只在用户明确要求时调用）。",
       parameters: SCHEDULE_PARAMETERS,
       async execute(args = {}) {
         try {
@@ -132,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,
@@ -155,6 +305,64 @@ export function apply(ctx, config) {
         }
       },
     });
+
+    // 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 {
+          const core = await loadCore();
+          const described = core.config?.describe ? core.config.describe() : { schema: {}, defaults: {} };
+          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 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, assistants: fleet.length };
+          return {
+            ok: false,
+            wrote: false,
+            reason: "need_human_confirmation",
+            command: `pactive config set ${key} ${rawValue} --confirm`,
+            hint: "不要自己改状态文件；把 command 原样给用户，等他执行后下一轮用 pactive_status 复核。",
+            values,
+          };
+        } catch (err) {
+          return { ok: false, error: errorText(err) };
+        }
+      },
+    });
   };
 
   const registerCommands = () => {

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,17 +36,50 @@ export const TOOL_DEFINITIONS = [
   {
     name: "pactive_status",
     description:
-      "Pactive 主动机制状态：空闲判定与 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.* / globalGuard.hourlyLimit）"),
+        value: str("想改成的新值；给了就只返回 `pactive config set <key> <value> --confirm`，不落盘"),
+        kind: str("提议哪种写操作：assistant.add | assistant.remove | assistant.enable（只返回命令，不落盘）"),
+        name: str("kind=assistant.* 时要操作的助理名或 id（缺 id 时用名字）"),
+      },
+      [],
+    ),
+  },
   {
     name: "pactive_schedule",
     description:
-      "登记一个定时任务（真正落盘）。when 支持时长（10m）、时刻（18:30）、ISO 时间、every 1h。",
+      "当用户说「10 分钟后提醒我喝水」「18:30 提醒我开会」「每小时检查一次」时用。" +
+      "→ 登记一条定时任务并立即落盘；when 支持 10m / 18:30 / ISO 8601 / every 1h；assistant 不填就记在默认助理名下。" +
+      "会写盘，需要人工确认（只在用户明确要求时调用）。",
     inputSchema: obj(
       {
         prompt: str("任务正文（到点注入给会话的内容）"),
         when: str("触发时间：时长 / 时刻 / ISO 8601 / every <时长>；缺省 10m"),
+        assistant: str("记在哪个助理名下（名字或 id）；不传 = 默认助理"),
       },
       ["prompt"],
     ),
@@ -53,7 +87,9 @@ export const TOOL_DEFINITIONS = [
   {
     name: "pactive_tell",
     description:
-      "给同机另一个会话投递一条消息。对端离线时进入 outbox 排队，不伪装成功。",
+      "当用户说「告诉另一个会话我有空」「问一下隔壁 agent 跑完了吗」时用。" +
+      "→ 给同机另一个会话投递消息；对端离线时进入 outbox 排队，不伪装成功。" +
+      "会写盘，需要人工确认（只在用户明确要求时调用）。",
     inputSchema: obj(
       {
         to: str("目标会话的 agentId 或名字"),
@@ -65,7 +101,9 @@ export const TOOL_DEFINITIONS = [
   },
   {
     name: "pactive_history",
-    description: "读取 Pactive 事件账本尾部（触发→投递→回应→结账），用于追溯主动行为。",
+    description:
+      "当用户问「刚才那几次主动提醒都发生了什么」「有没有真的触发过」时用。" +
+      "→ 读事件账本尾部（触发→投递→回应→结账）。只读。",
     inputSchema: obj({ limit: { type: "integer", description: "返回条数，默认 20" } }, []),
   },
 ];
@@ -79,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
@@ -101,36 +187,147 @@ 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 / 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 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 json({ ok: true, readOnly: true, wrote: false, values, assistants: fleet.length, stateFile: paths.stateFile });
+        }
+        return json({
+          ok: false,
+          readOnly: false,
+          wrote: false,
+          reason: "need_human_confirmation",
+          command: `pactive config set ${key} ${rawValue} --confirm`,
+          hint: "不要自己改状态文件；把 command 原样给用户，等他执行后下一轮用 pactive_status 复核。",
+          values,
+        });
+      }
+
       case "pactive_schedule": {
         const prompt = typeof args.prompt === "string" ? args.prompt.trim() : "";
         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.2-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",