npm - @rubytech/taskmaster - Versions diffs - 1.5.1 → 1.5.3 - Mend

@rubytech/taskmaster 1.5.1 → 1.5.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (29) hide show

package/dist/agents/skills/workspace.js +23 -2
package/dist/agents/taskmaster-tools.js +8 -0
package/dist/agents/tool-policy.js +4 -0
package/dist/agents/tools/skill-draft-save-tool.js +110 -0
package/dist/auto-reply/tokens.js +23 -0
package/dist/build-info.json +3 -3
package/dist/cli/provision-seed.js +1 -0
package/dist/config/defaults.js +32 -0
package/dist/config/io.js +4 -4
package/dist/config/legacy.migrations.part-3.js +51 -0
package/dist/config/validation.js +2 -2
package/dist/control-ui/assets/{index-D-PHW4mO.js → index-C12OTik-.js} +734 -614
package/dist/control-ui/assets/index-C12OTik-.js.map +1 -0
package/dist/control-ui/index.html +1 -1
package/dist/cron/isolated-agent/delivery-record.js +54 -0
package/dist/cron/isolated-agent/history.js +221 -0
package/dist/cron/isolated-agent/run.js +56 -2
package/dist/gateway/protocol/index.js +2 -1
package/dist/gateway/protocol/schema/agents-models-skills.js +9 -0
package/dist/gateway/protocol/schema/protocol-schemas.js +2 -1
package/dist/gateway/server-methods/skills.js +29 -5
package/dist/gateway/server.impl.js +17 -0
package/dist/memory/audit.js +19 -2
package/dist/memory/manager.js +1 -0
package/package.json +1 -1
package/skills/skill-builder/SKILL.md +13 -8
package/taskmaster-docs/USER-GUIDE.md +67 -8
package/templates/customer/agents/admin/BOOTSTRAP.md +1 -1
package/dist/control-ui/assets/index-D-PHW4mO.js.map +0 -1

package/dist/control-ui/index.html CHANGED Viewed

@@ -6,7 +6,7 @@
     <title>Taskmaster Control</title>
     <meta name="color-scheme" content="dark light" />
     <link rel="icon" type="image/png" href="./favicon.png" />
-    <script type="module" crossorigin src="./assets/index-D-PHW4mO.js"></script>
+    <script type="module" crossorigin src="./assets/index-C12OTik-.js"></script>
     <link rel="stylesheet" crossorigin href="./assets/index-D6WTmXJM.css">
   </head>
   <body>

package/dist/cron/isolated-agent/delivery-record.js ADDED Viewed

@@ -0,0 +1,54 @@
+import fs from "node:fs";
+import path from "node:path";
+/**
+ * Writes a delivery record to the agent's workspace memory so the admin agent
+ * can discover what was sent by cron jobs when recipients reply later.
+ *
+ * Files are stored in `memory/shared/cron-activity/` as dated markdown,
+ * discoverable via the agent's normal memory search.
+ */
+export async function writeCronDeliveryRecord(params) {
+    const { workspaceDir, jobName, jobId, agentOutput, deliveredTo, timestamp } = params;
+    if (!agentOutput.trim() || deliveredTo.length === 0)
+        return null;
+    const dir = path.join(workspaceDir, "memory", "shared", "cron-activity");
+    await fs.promises.mkdir(dir, { recursive: true });
+    const dateSlug = formatDateSlug(timestamp);
+    const nameSlug = slugify(jobName);
+    const idSuffix = jobId.slice(0, 8);
+    const fileName = `${dateSlug}-${nameSlug}-${idSuffix}.md`;
+    const filePath = path.join(dir, fileName);
+    const recipientLines = deliveredTo.map((d) => `- ${d.to} (${d.channel})`).join("\n");
+    const content = [
+        `# Cron delivery: ${jobName}`,
+        "",
+        `**Time:** ${timestamp.toISOString()}`,
+        `**Job ID:** ${jobId}`,
+        "",
+        "**Delivered to:**",
+        recipientLines,
+        "",
+        "## Message sent",
+        "",
+        agentOutput.trim(),
+        "",
+    ].join("\n");
+    await fs.promises.writeFile(filePath, content, "utf-8");
+    return filePath;
+}
+function formatDateSlug(date) {
+    const pad = (n) => String(n).padStart(2, "0");
+    return [
+        String(date.getFullYear()),
+        pad(date.getMonth() + 1),
+        pad(date.getDate()),
+        pad(date.getHours()) + pad(date.getMinutes()) + pad(date.getSeconds()),
+    ].join("-");
+}
+function slugify(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 40);
+}

package/dist/cron/isolated-agent/history.js ADDED Viewed

@@ -0,0 +1,221 @@
+import fs from "node:fs";
+import path from "node:path";
+import { loadSessionStore, resolveStorePath } from "../../config/sessions.js";
+/** Max characters per individual message in the context block. */
+const MAX_MESSAGE_CHARS = 500;
+/** Default number of recent user turns to include per session. */
+const DEFAULT_TURNS_PER_SESSION = 5;
+/** Default number of most-recently-active sessions to include. */
+const DEFAULT_MAX_SESSIONS = 15;
+/** Default cap on total user turns across all sessions combined. */
+const DEFAULT_MAX_TOTAL_TURNS = 30;
+/**
+ * Loads recent conversation messages from all non-cron sessions for a given agent
+ * and formats them as a context block for prepending to a cron job prompt.
+ *
+ * This enables isolated cron jobs (briefings, periodic checks) to be aware of
+ * recent agent interactions across all channels — WhatsApp, iMessage, web chat, etc.
+ */
+export function loadCrossChannelHistory(params) {
+    const turnsPerSession = params.turnsPerSession ?? DEFAULT_TURNS_PER_SESSION;
+    const maxSessions = params.maxSessions ?? DEFAULT_MAX_SESSIONS;
+    const maxTotalTurns = params.maxTotalTurns ?? DEFAULT_MAX_TOTAL_TURNS;
+    const storePath = resolveStorePath(params.cfg.session?.store, {
+        agentId: params.agentId,
+    });
+    let store;
+    try {
+        store = loadSessionStore(storePath);
+    }
+    catch {
+        return "";
+    }
+    const sessionsDir = path.dirname(storePath);
+    // Include only conversational sessions — exclude cron, hook, node, and subagent sessions.
+    const sessions = Object.entries(store)
+        .filter(([key]) => shouldIncludeSession(key))
+        .sort(([, a], [, b]) => (b.updatedAt ?? 0) - (a.updatedAt ?? 0))
+        .slice(0, maxSessions);
+    if (sessions.length === 0)
+        return "";
+    const blocks = [];
+    let totalTurns = 0;
+    for (const [sessionKey, entry] of sessions) {
+        const remaining = maxTotalTurns - totalTurns;
+        if (remaining <= 0)
+            break;
+        if (!entry.sessionId)
+            continue;
+        const transcriptPath = entry.sessionFile?.trim() || path.join(sessionsDir, `${entry.sessionId}.jsonl`);
+        const effectiveLimit = Math.min(turnsPerSession, remaining);
+        const turns = readRecentConversationTurns(transcriptPath, effectiveLimit);
+        if (turns.length === 0)
+            continue;
+        totalTurns += turns.filter((t) => t.role === "user").length;
+        const label = formatSessionLabel(sessionKey, entry);
+        const formatted = turns
+            .map((t) => {
+            const role = t.role === "user" ? "User" : "Assistant";
+            return `  ${role}: ${truncate(t.text, MAX_MESSAGE_CHARS)}`;
+        })
+            .join("\n");
+        blocks.push(`[${label}]\n${formatted}`);
+    }
+    if (blocks.length === 0)
+        return "";
+    return [
+        "--- Recent conversations across all channels (for context) ---",
+        "",
+        blocks.join("\n\n"),
+        "",
+        "--- End of recent conversations ---",
+    ].join("\n");
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Extract the session-specific portion after "agent:{agentId}:". */
+function extractSessionRest(key) {
+    const match = key.match(/^agent:[^:]+:(.+)$/);
+    return match?.[1] ?? key;
+}
+/** Only include conversational sessions — not system/background sessions. */
+function shouldIncludeSession(key) {
+    const rest = extractSessionRest(key);
+    if (rest.startsWith("cron:"))
+        return false;
+    if (rest.startsWith("hook:"))
+        return false;
+    if (rest.startsWith("node:") || rest.startsWith("node-"))
+        return false;
+    if (rest.startsWith("subagent:"))
+        return false;
+    if (rest.startsWith("acp:"))
+        return false;
+    return true;
+}
+/**
+ * Reads the last N conversation turns (user + assistant text) from a JSONL
+ * transcript file. Tool calls and tool results are stripped.
+ */
+function readRecentConversationTurns(transcriptPath, maxUserTurns) {
+    let content;
+    try {
+        content = fs.readFileSync(transcriptPath, "utf-8");
+    }
+    catch {
+        return [];
+    }
+    const lines = content.split(/\r?\n/);
+    const allTurns = [];
+    for (const line of lines) {
+        if (!line.trim())
+            continue;
+        try {
+            const parsed = JSON.parse(line);
+            const msg = parsed?.message;
+            if (!msg?.role)
+                continue;
+            if (msg.role !== "user" && msg.role !== "assistant")
+                continue;
+            const text = extractMessageText(msg);
+            if (!text)
+                continue;
+            allTurns.push({ role: msg.role, text });
+        }
+        catch {
+            // skip malformed lines
+        }
+    }
+    return limitToLastUserTurns(allTurns, maxUserTurns);
+}
+/**
+ * Keeps the last N user turns plus their associated assistant responses.
+ * Same logic as the main session history's `limitHistoryTurns`.
+ */
+function limitToLastUserTurns(turns, limit) {
+    if (turns.length === 0 || limit <= 0)
+        return [];
+    let userCount = 0;
+    let lastUserIndex = turns.length;
+    for (let i = turns.length - 1; i >= 0; i--) {
+        if (turns[i].role === "user") {
+            userCount++;
+            if (userCount > limit) {
+                return turns.slice(lastUserIndex);
+            }
+            lastUserIndex = i;
+        }
+    }
+    return turns;
+}
+/**
+ * Extracts text content from an agent message, handling both string content
+ * and content-block arrays. Tool-use blocks are excluded.
+ */
+function extractMessageText(msg) {
+    const content = msg.content;
+    if (typeof content === "string")
+        return content.trim() || null;
+    if (!Array.isArray(content))
+        return null;
+    const parts = [];
+    for (const block of content) {
+        if (!block || typeof block !== "object")
+            continue;
+        const b = block;
+        if (b.type === "text" && typeof b.text === "string") {
+            const trimmed = b.text.trim();
+            if (trimmed)
+                parts.push(trimmed);
+        }
+    }
+    return parts.join("\n") || null;
+}
+/** Human-readable label for a session key, e.g. "WhatsApp DM Joel (+447504472444)". */
+function formatSessionLabel(sessionKey, entry) {
+    const rest = extractSessionRest(sessionKey);
+    const name = entry.displayName?.trim();
+    if (rest === "main")
+        return "Main session";
+    // per-peer DM: dm:{peerId}
+    const dmMatch = rest.match(/^dm:(.+)$/);
+    if (dmMatch) {
+        const peerId = dmMatch[1];
+        const channel = entry.lastChannel ?? entry.channel;
+        const label = name ? `${name} (${peerId})` : peerId;
+        if (channel)
+            return `${capitalizeChannel(channel)} DM ${label}`;
+        return `DM ${label}`;
+    }
+    // per-channel-peer DM: {channel}:dm:{peerId}
+    const channelDmMatch = rest.match(/^([^:]+):dm:(.+)$/);
+    if (channelDmMatch) {
+        const peerId = channelDmMatch[2];
+        const label = name ? `${name} (${peerId})` : peerId;
+        return `${capitalizeChannel(channelDmMatch[1])} DM ${label}`;
+    }
+    // group/channel: {channel}:{group|channel}:{peerId}
+    const groupMatch = rest.match(/^([^:]+):(group|channel):(.+)$/);
+    if (groupMatch) {
+        const subject = entry.subject?.trim();
+        const peerId = groupMatch[3];
+        const label = subject ?? peerId;
+        return `${capitalizeChannel(groupMatch[1])} ${groupMatch[2]} ${label}`;
+    }
+    return rest;
+}
+function capitalizeChannel(channel) {
+    if (channel === "whatsapp")
+        return "WhatsApp";
+    if (channel === "imessage")
+        return "iMessage";
+    if (channel === "webchat")
+        return "Web chat";
+    return channel.charAt(0).toUpperCase() + channel.slice(1);
+}
+function truncate(text, maxChars) {
+    if (text.length <= maxChars)
+        return text;
+    return `${text.slice(0, maxChars)}…`;
+}

package/dist/cron/isolated-agent/run.js CHANGED Viewed

@@ -25,6 +25,10 @@ import { resolveAgentBoundAccountId } from "../../routing/bindings.js";
 import { resolveDeliveryTarget } from "./delivery-target.js";
 import { expandCronRecipients } from "./recipients.js";
 import { isHeartbeatOnlyResponse, pickLastNonEmptyTextFromPayloads, pickSummaryFromOutput, pickSummaryFromPayloads, resolveHeartbeatAckMaxChars, } from "./helpers.js";
+import { appendAssistantMessageToSessionTranscript } from "../../config/sessions/transcript.js";
+import { resolveOutboundSessionRoute } from "../../infra/outbound/outbound-session.js";
+import { writeCronDeliveryRecord } from "./delivery-record.js";
+import { loadCrossChannelHistory } from "./history.js";
 import { resolveCronSession } from "./session.js";
 function matchesMessagingToolDeliveryTarget(target, delivery) {
     if (!delivery.to || !target.to)
@@ -174,6 +178,19 @@ export async function runCronIsolatedAgentTurn(params) {
     const formattedTime = formatUserTime(new Date(now), userTimezone, userTimeFormat) ?? new Date(now).toISOString();
     const timeLine = `Current time: ${formattedTime} (${userTimezone})`;
     const commandBody = `${base}\n${timeLine}`.trim();
+    // Inject recent conversation history from all channels so the cron job
+    // has awareness of what has been discussed across WhatsApp, iMessage, web chat, etc.
+    const historyBlock = loadCrossChannelHistory({ cfg: params.cfg, agentId });
+    // When delivery is configured, the agent's response IS the message that gets sent.
+    // Instruct the agent to always produce a deliverable message — NO_REPLY would
+    // suppress delivery and defeat the purpose of the cron job.
+    const deliveryInstruction = deliveryRequested && hasExplicitTarget
+        ? "\n\nDELIVERY MODE: Your text response IS the message that will be sent to the recipient automatically. Write it as the final deliverable. The silent-reply rules (NO_REPLY) do not apply here — this is a scheduled job that always needs output. Do not use the message tool; delivery is handled for you."
+        : "";
+    const fullPrompt = [commandBody, historyBlock, deliveryInstruction]
+        .filter(Boolean)
+        .join("\n\n")
+        .trim();
     const existingSnapshot = cronSession.sessionEntry.skillsSnapshot;
     const skillsSnapshotVersion = getSkillsSnapshotVersion(workspaceDir);
     const needsSkillsSnapshot = !existingSnapshot || existingSnapshot.version !== skillsSnapshotVersion;
@@ -228,7 +245,7 @@ export async function runCronIsolatedAgentTurn(params) {
                         sessionFile,
                         workspaceDir,
                         config: cfgWithAgentDefaults,
-                        prompt: commandBody,
+                        prompt: fullPrompt,
                         provider: providerOverride,
                         model: modelOverride,
                         thinkLevel,
@@ -247,7 +264,7 @@ export async function runCronIsolatedAgentTurn(params) {
                     workspaceDir,
                     config: cfgWithAgentDefaults,
                     skillsSnapshot,
-                    prompt: commandBody,
+                    prompt: fullPrompt,
                     lane: params.lane ?? "cron",
                     provider: providerOverride,
                     model: modelOverride,
@@ -363,6 +380,43 @@ export async function runCronIsolatedAgentTurn(params) {
                 errors.push(`${targetTo}: ${String(err)}`);
             }
         }
+        // Mirror delivered message into each recipient's DM session transcript
+        // so the agent sees it in conversation history when the recipient replies.
+        // This is the same mechanism the message tool uses (delivery-mirror).
+        if (outputText) {
+            for (const targetTo of deliveryTargets) {
+                const route = await resolveOutboundSessionRoute({
+                    cfg: cfgWithAgentDefaults,
+                    channel: resolvedDelivery.channel,
+                    agentId,
+                    accountId: resolvedDelivery.accountId,
+                    target: targetTo,
+                });
+                if (route) {
+                    await appendAssistantMessageToSessionTranscript({
+                        agentId,
+                        sessionKey: route.sessionKey,
+                        text: outputText,
+                    }).catch(() => {
+                        /* best-effort — mirror is helpful but must not block delivery */
+                    });
+                }
+            }
+            // Also persist delivery record to memory for searchability.
+            await writeCronDeliveryRecord({
+                workspaceDir,
+                jobName: params.job.name,
+                jobId: params.job.id,
+                agentOutput: outputText,
+                deliveredTo: deliveryTargets.map((to) => ({
+                    to,
+                    channel: resolvedDelivery.channel,
+                })),
+                timestamp: new Date(),
+            }).catch(() => {
+                /* best-effort — delivery record is helpful but not required */
+            });
+        }
         if (errors.length > 0 && !bestEffortDeliver) {
             return {
                 status: "error",

package/dist/gateway/protocol/index.js CHANGED Viewed

@@ -1,5 +1,5 @@
 import AjvPkg from "ajv";
-import { AgentEventSchema, AgentIdentityParamsSchema, AgentIdentityResultSchema, AgentParamsSchema, AgentSummarySchema, AgentsListParamsSchema, AgentsListResultSchema, AgentWaitParamsSchema, ChannelsLogoutParamsSchema, ChannelsStatusParamsSchema, ChannelsStatusResultSchema, ChatAbortParamsSchema, ChatEventSchema, ChatHistoryParamsSchema, ChatInjectParamsSchema, ChatSendParamsSchema, ConfigApplyParamsSchema, ConfigGetParamsSchema, ConfigPatchParamsSchema, ConfigSchemaParamsSchema, ConfigSchemaResponseSchema, ConfigSetParamsSchema, ConnectParamsSchema, CronAddParamsSchema, CronJobSchema, CronListParamsSchema, CronRemoveParamsSchema, CronRunParamsSchema, CronRunsParamsSchema, CronStatusParamsSchema, CronUpdateParamsSchema, DevicePairApproveParamsSchema, DevicePairListParamsSchema, DevicePairRejectParamsSchema, DeviceTokenRevokeParamsSchema, DeviceTokenRotateParamsSchema, ExecApprovalsGetParamsSchema, ExecApprovalsNodeGetParamsSchema, ExecApprovalsNodeSetParamsSchema, ExecApprovalsSetParamsSchema, ExecApprovalRequestParamsSchema, ExecApprovalResolveParamsSchema, ErrorCodes, ErrorShapeSchema, EventFrameSchema, errorShape, GatewayFrameSchema, HelloOkSchema, LogsTailParamsSchema, LogsTailResultSchema, SessionsTranscriptParamsSchema, SessionsTranscriptResultSchema, ModelsListParamsSchema, NodeDescribeParamsSchema, NodeEventParamsSchema, NodeInvokeParamsSchema, NodeInvokeResultParamsSchema, NodeListParamsSchema, NodePairApproveParamsSchema, NodePairListParamsSchema, NodePairRejectParamsSchema, NodePairRequestParamsSchema, NodePairVerifyParamsSchema, NodeRenameParamsSchema, PollParamsSchema, PROTOCOL_VERSION, PresenceEntrySchema, ProtocolSchemas, RequestFrameSchema, ResponseFrameSchema, SendParamsSchema, SessionsCompactParamsSchema, SessionsDeleteParamsSchema, SessionsListParamsSchema, SessionsPatchParamsSchema, SessionsPreviewParamsSchema, SessionsResetParamsSchema, SessionsResolveParamsSchema, ShutdownEventSchema, SkillsBinsParamsSchema, SkillsCreateParamsSchema, SkillsDeleteParamsSchema, SkillsDeleteDraftParamsSchema, SkillsDraftsParamsSchema, SkillsInstallParamsSchema, SkillsReadParamsSchema, SkillsStatusParamsSchema, SkillsUpdateParamsSchema, SnapshotSchema, StateVersionSchema, TalkModeParamsSchema, TickEventSchema, UpdateRunParamsSchema, WakeParamsSchema, WebLoginStartParamsSchema, WebLoginWaitParamsSchema, WizardCancelParamsSchema, WizardNextParamsSchema, WizardNextResultSchema, WizardStartParamsSchema, WizardStartResultSchema, WizardStatusParamsSchema, WizardStatusResultSchema, WizardStepSchema, } from "./schema.js";
+import { AgentEventSchema, AgentIdentityParamsSchema, AgentIdentityResultSchema, AgentParamsSchema, AgentSummarySchema, AgentsListParamsSchema, AgentsListResultSchema, AgentWaitParamsSchema, ChannelsLogoutParamsSchema, ChannelsStatusParamsSchema, ChannelsStatusResultSchema, ChatAbortParamsSchema, ChatEventSchema, ChatHistoryParamsSchema, ChatInjectParamsSchema, ChatSendParamsSchema, ConfigApplyParamsSchema, ConfigGetParamsSchema, ConfigPatchParamsSchema, ConfigSchemaParamsSchema, ConfigSchemaResponseSchema, ConfigSetParamsSchema, ConnectParamsSchema, CronAddParamsSchema, CronJobSchema, CronListParamsSchema, CronRemoveParamsSchema, CronRunParamsSchema, CronRunsParamsSchema, CronStatusParamsSchema, CronUpdateParamsSchema, DevicePairApproveParamsSchema, DevicePairListParamsSchema, DevicePairRejectParamsSchema, DeviceTokenRevokeParamsSchema, DeviceTokenRotateParamsSchema, ExecApprovalsGetParamsSchema, ExecApprovalsNodeGetParamsSchema, ExecApprovalsNodeSetParamsSchema, ExecApprovalsSetParamsSchema, ExecApprovalRequestParamsSchema, ExecApprovalResolveParamsSchema, ErrorCodes, ErrorShapeSchema, EventFrameSchema, errorShape, GatewayFrameSchema, HelloOkSchema, LogsTailParamsSchema, LogsTailResultSchema, SessionsTranscriptParamsSchema, SessionsTranscriptResultSchema, ModelsListParamsSchema, NodeDescribeParamsSchema, NodeEventParamsSchema, NodeInvokeParamsSchema, NodeInvokeResultParamsSchema, NodeListParamsSchema, NodePairApproveParamsSchema, NodePairListParamsSchema, NodePairRejectParamsSchema, NodePairRequestParamsSchema, NodePairVerifyParamsSchema, NodeRenameParamsSchema, PollParamsSchema, PROTOCOL_VERSION, PresenceEntrySchema, ProtocolSchemas, RequestFrameSchema, ResponseFrameSchema, SendParamsSchema, SessionsCompactParamsSchema, SessionsDeleteParamsSchema, SessionsListParamsSchema, SessionsPatchParamsSchema, SessionsPreviewParamsSchema, SessionsResetParamsSchema, SessionsResolveParamsSchema, ShutdownEventSchema, SkillsBinsParamsSchema, SkillsCreateParamsSchema, SkillsDeleteParamsSchema, SkillsDeleteDraftParamsSchema, SkillsDraftsParamsSchema, SkillsSaveDraftParamsSchema, SkillsInstallParamsSchema, SkillsReadParamsSchema, SkillsStatusParamsSchema, SkillsUpdateParamsSchema, SnapshotSchema, StateVersionSchema, TalkModeParamsSchema, TickEventSchema, UpdateRunParamsSchema, WakeParamsSchema, WebLoginStartParamsSchema, WebLoginWaitParamsSchema, WizardCancelParamsSchema, WizardNextParamsSchema, WizardNextResultSchema, WizardStartParamsSchema, WizardStartResultSchema, WizardStatusParamsSchema, WizardStatusResultSchema, WizardStepSchema, } from "./schema.js";
 const ajv = new AjvPkg({
     allErrors: true,
     strict: false,
@@ -55,6 +55,7 @@ export const validateSkillsReadParams = ajv.compile(SkillsReadParamsSchema);
 export const validateSkillsCreateParams = ajv.compile(SkillsCreateParamsSchema);
 export const validateSkillsDeleteParams = ajv.compile(SkillsDeleteParamsSchema);
 export const validateSkillsDraftsParams = ajv.compile(SkillsDraftsParamsSchema);
+export const validateSkillsSaveDraftParams = ajv.compile(SkillsSaveDraftParamsSchema);
 export const validateSkillsDeleteDraftParams = ajv.compile(SkillsDeleteDraftParamsSchema);
 export const validateCronListParams = ajv.compile(CronListParamsSchema);
 export const validateCronStatusParams = ajv.compile(CronStatusParamsSchema);

package/dist/gateway/protocol/schema/agents-models-skills.js CHANGED Viewed

@@ -65,6 +65,15 @@ export const SkillsDeleteParamsSchema = Type.Object({
     name: NonEmptyString,
 }, { additionalProperties: false });
 export const SkillsDraftsParamsSchema = Type.Object({}, { additionalProperties: false });
+export const SkillsSaveDraftParamsSchema = Type.Object({
+    name: Type.String({
+        pattern: "^[a-z0-9][a-z0-9_-]*$",
+        minLength: 1,
+        description: "Skill directory name (lowercase, hyphens, underscores)",
+    }),
+    skillContent: NonEmptyString,
+    references: Type.Optional(Type.Array(SkillReferenceFileSchema)),
+}, { additionalProperties: false });
 export const SkillsDeleteDraftParamsSchema = Type.Object({
     name: NonEmptyString,
 }, { additionalProperties: false });

package/dist/gateway/protocol/schema/protocol-schemas.js CHANGED Viewed

@@ -1,5 +1,5 @@
 import { AgentEventSchema, AgentIdentityParamsSchema, AgentIdentityResultSchema, AgentParamsSchema, AgentWaitParamsSchema, PollParamsSchema, SendParamsSchema, WakeParamsSchema, } from "./agent.js";
-import { AgentSummarySchema, AgentsListParamsSchema, AgentsListResultSchema, ModelChoiceSchema, ModelsListParamsSchema, ModelsListResultSchema, SkillsBinsParamsSchema, SkillsBinsResultSchema, SkillsCreateParamsSchema, SkillsDeleteParamsSchema, SkillsDeleteDraftParamsSchema, SkillsDraftsParamsSchema, SkillsInstallParamsSchema, SkillsReadParamsSchema, SkillsStatusParamsSchema, SkillsUpdateParamsSchema, } from "./agents-models-skills.js";
+import { AgentSummarySchema, AgentsListParamsSchema, AgentsListResultSchema, ModelChoiceSchema, ModelsListParamsSchema, ModelsListResultSchema, SkillsBinsParamsSchema, SkillsBinsResultSchema, SkillsCreateParamsSchema, SkillsDeleteParamsSchema, SkillsDeleteDraftParamsSchema, SkillsDraftsParamsSchema, SkillsSaveDraftParamsSchema, SkillsInstallParamsSchema, SkillsReadParamsSchema, SkillsStatusParamsSchema, SkillsUpdateParamsSchema, } from "./agents-models-skills.js";
 import { ChannelsLogoutParamsSchema, ChannelsStatusParamsSchema, ChannelsStatusResultSchema, TalkModeParamsSchema, WebLoginStartParamsSchema, WebLoginWaitParamsSchema, } from "./channels.js";
 import { ConfigApplyParamsSchema, ConfigGetParamsSchema, ConfigPatchParamsSchema, ConfigSchemaParamsSchema, ConfigSchemaResponseSchema, ConfigSetParamsSchema, UpdateRunParamsSchema, } from "./config.js";
 import { CronAddParamsSchema, CronJobSchema, CronListParamsSchema, CronRemoveParamsSchema, CronRunLogEntrySchema, CronRunParamsSchema, CronRunsParamsSchema, CronStatusParamsSchema, CronUpdateParamsSchema, } from "./cron.js";
@@ -84,6 +84,7 @@ export const ProtocolSchemas = {
     SkillsCreateParams: SkillsCreateParamsSchema,
     SkillsDeleteParams: SkillsDeleteParamsSchema,
     SkillsDraftsParams: SkillsDraftsParamsSchema,
+    SkillsSaveDraftParams: SkillsSaveDraftParamsSchema,
     SkillsDeleteDraftParams: SkillsDeleteDraftParamsSchema,
     CronJob: CronJobSchema,
     CronListParams: CronListParamsSchema,

package/dist/gateway/server-methods/skills.js CHANGED Viewed

@@ -1,13 +1,13 @@
 import fs from "node:fs";
 import path from "node:path";
-import { resolveAgentWorkspaceDir, resolveAgentWorkspaceRoot, resolveDefaultAgentId } from "../../agents/agent-scope.js";
+import { resolveAgentWorkspaceDir, resolveAgentWorkspaceRoot, resolveDefaultAgentId, } from "../../agents/agent-scope.js";
 import { installSkill } from "../../agents/skills-install.js";
 import { buildWorkspaceSkillStatus } from "../../agents/skills-status.js";
-import { loadWorkspaceSkillEntries, resolveBundledSkillsDir } from "../../agents/skills.js";
+import { loadWorkspaceSkillEntries, resolveBundledSkillsDir, } from "../../agents/skills.js";
 import { bumpSkillsSnapshotVersion } from "../../agents/skills/refresh.js";
 import { loadConfig, writeConfigFile } from "../../config/config.js";
 import { getRemoteSkillEligibility } from "../../infra/skills-remote.js";
-import { ErrorCodes, errorShape, formatValidationErrors, validateSkillsBinsParams, validateSkillsCreateParams, validateSkillsDeleteDraftParams, validateSkillsDeleteParams, validateSkillsDraftsParams, validateSkillsInstallParams, validateSkillsReadParams, validateSkillsStatusParams, validateSkillsUpdateParams, } from "../protocol/index.js";
+import { ErrorCodes, errorShape, formatValidationErrors, validateSkillsBinsParams, validateSkillsCreateParams, validateSkillsDeleteDraftParams, validateSkillsDeleteParams, validateSkillsDraftsParams, validateSkillsInstallParams, validateSkillsReadParams, validateSkillsSaveDraftParams, validateSkillsStatusParams, validateSkillsUpdateParams, } from "../protocol/index.js";
 function listWorkspaceDirs(cfg) {
     const dirs = new Set();
     const list = cfg.agents?.list;
@@ -56,8 +56,7 @@ function isPreloadedSkill(skillKey) {
     if (!dir)
         return false;
     try {
-        return fs.existsSync(`${dir}/${skillKey}`) &&
-            fs.statSync(`${dir}/${skillKey}`).isDirectory();
+        return fs.existsSync(`${dir}/${skillKey}`) && fs.statSync(`${dir}/${skillKey}`).isDirectory();
     }
     catch {
         return false;
@@ -274,6 +273,31 @@ export const skillsHandlers = {
         }
         respond(true, { drafts }, undefined);
     },
+    "skills.saveDraft": ({ params, respond }) => {
+        if (!validateSkillsSaveDraftParams(params)) {
+            respond(false, undefined, errorShape(ErrorCodes.INVALID_REQUEST, `invalid skills.saveDraft params: ${formatValidationErrors(validateSkillsSaveDraftParams.errors)}`));
+            return;
+        }
+        const p = params;
+        const cfg = loadConfig();
+        const root = resolveWorkspaceRoot(cfg);
+        const draftDir = path.join(root, ".skill-drafts", p.name);
+        // Clean replace if it already exists
+        if (fs.existsSync(draftDir)) {
+            fs.rmSync(draftDir, { recursive: true, force: true });
+        }
+        fs.mkdirSync(draftDir, { recursive: true });
+        fs.writeFileSync(path.join(draftDir, "SKILL.md"), p.skillContent, "utf-8");
+        if (p.references && p.references.length > 0) {
+            const refsDir = path.join(draftDir, "references");
+            fs.mkdirSync(refsDir, { recursive: true });
+            for (const ref of p.references) {
+                const safeName = ref.name.replace(/[^a-zA-Z0-9._-]/g, "-");
+                fs.writeFileSync(path.join(refsDir, safeName), ref.content, "utf-8");
+            }
+        }
+        respond(true, { ok: true, name: p.name }, undefined);
+    },
     "skills.deleteDraft": ({ params, respond }) => {
         if (!validateSkillsDeleteDraftParams(params)) {
             respond(false, undefined, errorShape(ErrorCodes.INVALID_REQUEST, `invalid skills.deleteDraft params: ${formatValidationErrors(validateSkillsDeleteDraftParams.errors)}`));

package/dist/gateway/server.impl.js CHANGED Viewed

@@ -102,6 +102,23 @@ export async function startGatewayServer(port = 18789, opts = {}) {
                 .join("\n")}`);
         }
     }
+    // Persist default model fallbacks to config if missing.  The in-memory
+    // defaults cover runtime, but writing to disk makes the fallback chain
+    // visible in the config file and survives across gateway restarts.
+    if (configSnapshot.exists && !isNixMode) {
+        const parsed = configSnapshot.parsed;
+        const agentsRaw = parsed?.agents;
+        const defaultsRaw = agentsRaw?.defaults;
+        const modelRaw = defaultsRaw?.model;
+        const fallbacks = modelRaw?.fallbacks;
+        if (!Array.isArray(fallbacks) || fallbacks.length === 0) {
+            const { config: migrated, changes } = migrateLegacyConfig(parsed ?? {});
+            if (migrated && changes.length > 0) {
+                await writeConfigFile(migrated);
+                log.info(`gateway: applied config defaults:\n${changes.map((entry) => `- ${entry}`).join("\n")}`);
+            }
+        }
+    }
     configSnapshot = await readConfigFileSnapshot();
     if (configSnapshot.exists && !configSnapshot.valid) {
         const issues = configSnapshot.issues.length > 0

package/dist/memory/audit.js CHANGED Viewed

@@ -15,7 +15,7 @@ import fs from "node:fs";
 import path from "node:path";
 const AUDIT_FILENAME = ".memory-audit.json";
 /** Paths that are excluded from audit — expected operational writes. */
-const EXCLUDED_PREFIXES = ["memory/shared/events/"];
+const EXCLUDED_PREFIXES = ["memory/shared/events/", "memory/shared/cron-activity/"];
 /**
  * Returns true if a memory write path should be audited.
  * Auditable paths: memory/shared/** and memory/public/** (excluding exemptions).
@@ -59,7 +59,11 @@ function writeAuditFile(workspaceDir, data) {
 const DEDUP_WINDOW_MS = 60_000;
 /**
  * Record an audit entry for a memory write.
- * Skips the entry if an identical path+agent combination was recorded within the dedup window.
+ *
+ * Skips the entry if:
+ * - Same path + agent was recorded within the dedup window (rapid successive writes), OR
+ * - The most recent entry for the same path has the same content hash
+ *   (re-discovery of unchanged content during a search index rebuild)
  */
 export function recordAuditEntry(workspaceDir, entry) {
     const audit = readAuditFile(workspaceDir);
@@ -69,6 +73,19 @@ export function recordAuditEntry(workspaceDir, entry) {
         entry.timestamp - e.timestamp < DEDUP_WINDOW_MS);
     if (dominated)
         return;
+    // Content-hash dedup: skip if the most recent entry for this path has the same hash.
+    // This prevents re-alerting when the search index is rebuilt (full reindex) but
+    // the file content hasn't actually changed.
+    if (entry.hash) {
+        let latestForPath;
+        for (const e of audit.entries) {
+            if (e.path === entry.path && (!latestForPath || e.timestamp > latestForPath.timestamp)) {
+                latestForPath = e;
+            }
+        }
+        if (latestForPath?.hash === entry.hash)
+            return;
+    }
     audit.entries.push(entry);
     // Cap at 500 entries to prevent unbounded growth.
     if (audit.entries.length > 500) {

package/dist/memory/manager.js CHANGED Viewed

@@ -1281,6 +1281,7 @@ export class MemoryIndexManager {
                     path: entry.path,
                     timestamp: Date.now(),
                     agentId: this.agentId,
+                    hash: entry.hash,
                 });
             }
             await this.indexFile(entry, { source: "memory" });

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@rubytech/taskmaster",
-  "version": "1.5.1",
+  "version": "1.5.3",
   "description": "AI-powered business assistant for small businesses",
   "publishConfig": {
     "access": "public"

package/skills/skill-builder/SKILL.md CHANGED Viewed

@@ -71,14 +71,19 @@ Show the user the complete SKILL.md content and each reference file. Ask them to
 ## Step 6: Save the Draft
-Use your `write` tool to save the skill as a draft:
-1. Create `../../.skill-drafts/{name}/SKILL.md` with the composed content
-2. For each reference file: create `../../.skill-drafts/{name}/references/{filename}`
-The `../../` resolves from your agent directory to the workspace root. The `.skill-drafts/` folder at the workspace root is where the Control Panel looks for drafts.
-**Important:** Write to `.skill-drafts/`, NOT directly to `skills/`. The user installs the skill through the Control Panel.
+Use the `skill_draft_save` tool:
+```
+skill_draft_save({
+  name: "{name}",
+  skill_content: "...",       // full SKILL.md including frontmatter
+  references: [               // optional — omit if no reference files
+    { name: "filename.md", content: "..." }
+  ]
+})
+```
+The tool saves the draft to the correct location where the Control Panel looks for drafts. Do not use `memory_write` or `write` — those save to the wrong location.
 ## Step 7: Direct to Control Panel