@rubytech/taskmaster 1.16.3 → 1.17.4

package/dist/agents/tools/logs-read-tool.js

@@ -24,6 +24,9 @@ const LogsReadSchema = Type.Object({
     agents: Type.Optional(Type.Array(Type.String(), {
         description: 'Filter session logs to specific agent IDs (e.g. ["admin", "public"]). Sessions action only.',
     })),
+    minLevel: Type.Optional(stringEnum(["fatal", "error", "warn", "info"], {
+        description: 'Filter system log entries to this severity or above. Use "warn" for health checks to avoid context overflow. Only applies to action: "system".',
+    })),
 });
 export function createLogsReadTool() {
     return {
@@ -44,19 +47,25 @@ export function createLogsReadTool() {
                 const cursor = typeof params.cursor === "number" && Number.isFinite(params.cursor)
                     ? Math.max(0, Math.floor(params.cursor))
                     : undefined;
+                const minLevel = typeof params.minLevel === "string" ? params.minLevel : undefined;
                 const result = await callGatewayTool("logs.tail", {}, {
                     limit,
                     ...(cursor !== undefined ? { cursor } : {}),
+                    ...(minLevel !== undefined ? { minLevel } : {}),
                 });
                 return jsonResult(result);
             }
             if (action === "sessions") {
+                if (params.minLevel !== undefined) {
+                    throw new Error('minLevel is not supported for action "sessions"');
+                }
                 const limit = typeof params.limit === "number" && Number.isFinite(params.limit)
                     ? Math.max(1, Math.floor(params.limit))
                     : 100;
                 const agents = readStringArrayParam(params, "agents");
                 const result = await callGatewayTool("sessions.transcript", {}, {
                     limit,
+                    errorsOnly: true,
                     ...(agents ? { agents } : {}),
                 });
                 return jsonResult(result);

package/dist/agents/tools/memory-tool.js

@@ -148,6 +148,7 @@ export function createMemoryWriteTool(options) {
         description: "Write or append content to a file in the memory/ directory. " +
             "Path must be within the session's allowed scope. " +
             "Phone numbers in paths MUST include the + prefix (e.g., memory/users/+447734875155/profile.md). " +
+            "Group IDs in paths MUST include the @g.us suffix (e.g., memory/groups/120363425419890848@g.us/context.md). " +
             "Creates parent directories if needed. Use mode='append' to add to existing content.",
         parameters: MemoryWriteSchema,
         execute: async (_toolCallId, params) => {

package/dist/agents/workspace-migrations.js

@@ -631,6 +631,65 @@ async function patchBeagleAdminDispatchInstructions(_agentsPath, content) {
     }
     return result;
 }
+// ---------------------------------------------------------------------------
+// Migration: Beagle Zanzibar — Public agent tourist_phone field name (v1.17)
+// ---------------------------------------------------------------------------
+//
+// Replaces `tourist_id:` with `tourist_phone:` in the dispatch file format
+// examples and the Step 0 description. The hook parser looks for `tourist_phone`
+// and previously would receive "unknown" when the agent wrote `tourist_id`.
+async function patchBeaglePublicTouristPhone(_agentsPath, content) {
+    if (!isBeaglePublicAgent(content))
+        return null;
+    // Already migrated (or never had tourist_id)?
+    if (!content.includes("tourist_id"))
+        return null;
+    return content
+        .replace(/tourist_id: \[the tourist's phone number[^\]]*\]/g, "tourist_phone: [the tourist's phone number — from WhatsApp session or OTP-verified phone]")
+        .replace(/tourist_id: \[same identifier used in trip-request\]/g, "tourist_phone: [same phone used in trip-request]")
+        .replace(/Use it as the `tourist_id` in dispatch files\./g, "Use it as `tourist_phone` in dispatch files.")
+        .replace(/tourist_id:/g, "tourist_phone:");
+}
+// ---------------------------------------------------------------------------
+// Migration: Beagle Zanzibar — Admin Driver Reply explicit message tool (v1.17)
+// ---------------------------------------------------------------------------
+//
+// Replaces the vague "compile and send offers to the tourist" Driver Reply
+// instruction with an explicit step-by-step that uses the `message` tool
+// directly. Also updates Trip Request step 7 from "write offers dispatch file"
+// to "message tourist directly" — the old approach created a file that nothing
+// processed, stalling the booking flow.
+const ADMIN_DRIVER_REPLY_OLD = `Process the driver's message in the context of the ongoing negotiation. If it's a fare quote, note it. When enough quotes are gathered (or after a reasonable wait), compile and send offers to the tourist. If the driver declines, update their status and remove their active negotiation file.`;
+const ADMIN_DRIVER_REPLY_NEW = `1. If the driver is quoting a fare: record it in their memory profile (\`memory_write\` on \`drivers/{name}.md\`)
+2. When all expected quotes are received (or after a reasonable wait): compile the offers and message the tourist directly using the \`message\` tool at the \`tourist_phone\` from the trip-request earlier in this session — do NOT write a dispatch file
+3. If the driver is declining: update their status in memory to \`idle\` and delete their \`shared/active-negotiations/{phone-digits}.md\` file`;
+const ADMIN_TRIP_REQUEST_OFFERS_OLD = `8. Message the tourist with up to 3 competing offers — fare, rating, vehicle type, journey time. Do NOT reveal driver name, phone, or plate (gated by payment)`;
+const ADMIN_TRIP_REQUEST_OFFERS_NEW = `7. Message the tourist at \`tourist_phone\` using the \`message\` tool with \`accountId\` from this dispatch
+   - Include up to 3 offers: fare, vehicle type, driver rating, estimated journey time
+   - Do NOT reveal driver name, phone, or plate — those are gated by payment
+   - Cross-agent echo will relay the WhatsApp message to the tourist's active session automatically
+   - Do NOT write a dispatch file for the offers — message directly`;
+async function patchBeagleAdminDriverReplyExplicit(_agentsPath, content) {
+    if (!isBeagleTaxiAdmin(content))
+        return null;
+    // Already migrated?
+    if (content.includes("do NOT write a dispatch file"))
+        return null;
+    // Only migrate if the old vague text is present
+    if (!content.includes(ADMIN_DRIVER_REPLY_OLD))
+        return null;
+    let result = content.replace(ADMIN_DRIVER_REPLY_OLD, ADMIN_DRIVER_REPLY_NEW);
+    // Also update Trip Request offers step if old text present
+    if (result.includes(ADMIN_TRIP_REQUEST_OFFERS_OLD)) {
+        // Remove preceding step 7 ("Message the tourist confirming...") and update step 8
+        result = result
+            .replace("6. Message the tourist confirming drivers have been contacted and quotes are being gathered\n7. When driver replies arrive (dispatched as `[System: Ride Dispatch — Driver Reply]`), compile offers\n" +
+            ADMIN_TRIP_REQUEST_OFFERS_OLD, "6. When driver replies arrive (dispatched as `[System: Ride Dispatch — Driver Reply]`), compile offers\n" +
+            ADMIN_TRIP_REQUEST_OFFERS_NEW)
+            .replace(ADMIN_TRIP_REQUEST_OFFERS_OLD, ADMIN_TRIP_REQUEST_OFFERS_NEW);
+    }
+    return result;
+}
 const MIGRATIONS = [
     { name: "skill-recommendations", apply: patchSkillRecommendations },
     { name: "owner-learning", apply: patchOwnerLearning },
@@ -645,6 +704,8 @@ const MIGRATIONS = [
     { name: "beagle-public-dispatch-workflow", apply: patchBeaglePublicDispatchWorkflow },
     { name: "beagle-public-tools-dispatch", apply: patchBeaglePublicToolsDispatch },
     { name: "beagle-admin-dispatch-instructions", apply: patchBeagleAdminDispatchInstructions },
+    { name: "beagle-public-tourist-phone", apply: patchBeaglePublicTouristPhone },
+    { name: "beagle-admin-driver-reply-explicit", apply: patchBeagleAdminDriverReplyExplicit },
 ];
 /**
  * Run all workspace migrations for every configured agent.

package/dist/auto-reply/group-activation.js

@@ -5,6 +5,8 @@ export function normalizeGroupActivation(raw) {
         return "mention";
     if (value === "always")
         return "always";
+    if (value === "off")
+        return "off";
     return undefined;
 }
 export function parseActivationCommand(raw) {

package/dist/auto-reply/reply/commands-session.js

@@ -1,8 +1,10 @@
 import { abortEmbeddedPiRun } from "../../agents/pi-embedded.js";
+import { loadConfig, writeConfigFile } from "../../config/config.js";
 import { updateSessionStore } from "../../config/sessions.js";
 import { logVerbose } from "../../globals.js";
 import { createInternalHookEvent, triggerInternalHook } from "../../hooks/internal-hooks.js";
 import { scheduleGatewaySigusr1Restart, triggerTaskmasterRestart } from "../../infra/restart.js";
+import { normalizeAccountId } from "../../routing/session-key.js";
 import { parseActivationCommand } from "../group-activation.js";
 import { parseSendPolicyCommand } from "../send-policy.js";
 import { normalizeUsageDisplay, resolveResponseUsageMode } from "../thinking.js";
@@ -51,20 +53,35 @@ export const handleActivationCommand = async (params, allowTextCommands) => {
     if (!activationCommand.mode) {
         return {
             shouldContinue: false,
-            reply: { text: "⚙️ Usage: /activation mention|always" },
+            reply: { text: "⚙️ Usage: /activation mention|always|off" },
         };
     }
-    if (params.sessionEntry && params.sessionStore && params.sessionKey) {
-        params.sessionEntry.groupActivation = activationCommand.mode;
-        params.sessionEntry.groupActivationNeedsSystemIntro = true;
-        params.sessionEntry.updatedAt = Date.now();
-        params.sessionStore[params.sessionKey] = params.sessionEntry;
-        if (params.storePath) {
-            await updateSessionStore(params.storePath, (store) => {
-                store[params.sessionKey] = params.sessionEntry;
-            });
-        }
+    const groupId = params.ctx.From ?? params.sessionKey;
+    const accountId = normalizeAccountId(params.ctx.AccountId);
+    const cfg = loadConfig();
+    if (!cfg.channels)
+        cfg.channels = {};
+    if (!cfg.channels.whatsapp)
+        cfg.channels.whatsapp = {};
+    const wa = cfg.channels.whatsapp;
+    if (accountId !== "default") {
+        if (!wa.accounts)
+            wa.accounts = {};
+        const accounts = wa.accounts;
+        if (!accounts[accountId])
+            accounts[accountId] = {};
+        if (!accounts[accountId].groups)
+            accounts[accountId].groups = {};
+        const groups = accounts[accountId].groups;
+        groups[groupId] = { ...groups[groupId], activation: activationCommand.mode };
+    }
+    else {
+        if (!wa.groups)
+            wa.groups = {};
+        const groups = wa.groups;
+        groups[groupId] = { ...groups[groupId], activation: activationCommand.mode };
     }
+    await writeConfigFile(cfg);
     return {
         shouldContinue: false,
         reply: {

package/dist/build-info.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.16.3",
-  "commit": "af58918a990e50515497bcf76baad99133a4ff5f",
-  "builtAt": "2026-03-04T18:05:39.829Z"
+  "version": "1.17.4",
+  "commit": "6926faba7483a7c9b1ec7c332c593b866db3edb3",
+  "builtAt": "2026-03-05T13:47:06.682Z"
 }

package/dist/config/agent-tools-reconcile.js

@@ -156,6 +156,64 @@ export function reconcileQrGenerateTool(params) {
     }
     return { config, changes };
 }
+/**
+ * Individual control-panel tool names that should be replaced by `group:control-panel`.
+ * Matches the members of TOOL_GROUPS["group:control-panel"] in tool-policy.ts.
+ */
+const INDIVIDUAL_CONTROL_PANEL_TOOLS = [
+    "system_status",
+    "usage_report",
+    "channel_settings",
+    "brand_settings",
+    "opening_hours",
+    "public_chat_settings",
+    "skill_manage",
+    "logs_read",
+];
+/**
+ * Ensure admin agents use `group:control-panel` instead of individual control-panel tools.
+ *
+ * Agents set up before `group:control-panel` was introduced have individual tool
+ * entries in their explicit allow lists and therefore miss tools added to the group
+ * later (e.g. `logs_read`). This reconciliation replaces those individual entries
+ * with the group reference so the agent always sees the full, current set.
+ *
+ * Runs unconditionally on gateway startup. Idempotent — skips agents that already
+ * have `group:control-panel` or have no individual control-panel tools.
+ */
+export function reconcileControlPanelTools(params) {
+    const config = structuredClone(params.config);
+    const changes = [];
+    const agents = config.agents?.list;
+    if (!Array.isArray(agents))
+        return { config, changes };
+    for (const agent of agents) {
+        if (!agent || !isAdminAgent(agent))
+            continue;
+        const allow = agent.tools?.allow;
+        if (!Array.isArray(allow))
+            continue;
+        // Already using the group — nothing to do
+        if (allow.includes("group:control-panel"))
+            continue;
+        // Check if any individual control-panel tools are present
+        const hasAny = INDIVIDUAL_CONTROL_PANEL_TOOLS.some((t) => allow.includes(t));
+        if (!hasAny)
+            continue;
+        // Remove individual entries, add group
+        const removed = [];
+        for (const tool of INDIVIDUAL_CONTROL_PANEL_TOOLS) {
+            const idx = allow.indexOf(tool);
+            if (idx !== -1) {
+                allow.splice(idx, 1);
+                removed.push(tool);
+            }
+        }
+        allow.push("group:control-panel");
+        changes.push(`Replaced ${removed.join(", ")} with group:control-panel in agent "${agent.id}" tools.allow.`);
+    }
+    return { config, changes };
+}
 /**
  * Remove privileged tools (`message`, `contact_lookup`, `group:contacts`) from
  * Beagle public agent allow lists.

package/dist/config/group-policy.js

@@ -52,3 +52,19 @@ export function resolveChannelGroupToolsPolicy(params) {
         return defaultConfig.tools;
     return undefined;
 }
+export function resolveChannelGroupActivation(params) {
+    const { groupConfig, defaultConfig } = resolveChannelGroupPolicy(params);
+    // Prefer explicit `activation` field over deprecated `requireMention`
+    if (groupConfig?.activation != null)
+        return groupConfig.activation;
+    if (defaultConfig?.activation != null)
+        return defaultConfig.activation;
+    // Fall back to legacy requireMention boolean
+    if (typeof groupConfig?.requireMention === "boolean") {
+        return groupConfig.requireMention ? "mention" : "always";
+    }
+    if (typeof defaultConfig?.requireMention === "boolean") {
+        return defaultConfig.requireMention ? "mention" : "always";
+    }
+    return undefined;
+}

package/dist/config/zod-schema.providers-whatsapp.js

@@ -31,6 +31,7 @@ export const WhatsAppAccountSchema = z
     groups: z
         .record(z.string(), z
         .object({
+        activation: z.enum(["always", "mention", "off"]).optional(),
         requireMention: z.boolean().optional(),
         tools: ToolPolicySchema,
     })
@@ -93,6 +94,7 @@ export const WhatsAppConfigSchema = z
     groups: z
         .record(z.string(), z
         .object({
+        activation: z.enum(["always", "mention", "off"]).optional(),
         requireMention: z.boolean().optional(),
         tools: ToolPolicySchema,
     })