@rubytech/taskmaster 1.14.2 → 1.16.1

package/dist/agents/skills/frontmatter.js

@@ -90,6 +90,7 @@ export function resolveTaskmasterMetadata(frontmatter) {
         const osRaw = normalizeStringList(taskmasterObj.os);
         return {
             always: typeof taskmasterObj.always === "boolean" ? taskmasterObj.always : undefined,
+            embed: typeof taskmasterObj.embed === "boolean" ? taskmasterObj.embed : undefined,
             emoji: typeof taskmasterObj.emoji === "string" ? taskmasterObj.emoji : undefined,
             homepage: typeof taskmasterObj.homepage === "string" ? taskmasterObj.homepage : undefined,
             skillKey: typeof taskmasterObj.skillKey === "string" ? taskmasterObj.skillKey : undefined,

package/dist/agents/skills/workspace.js

@@ -18,32 +18,73 @@ function escapeXml(str) {
         .replace(/"/g, """)
         .replace(/'/g, "'");
 }
+/**
+ * Strip YAML frontmatter (between opening and closing `---`) from a skill
+ * file, returning only the body content.
+ */
+function stripFrontmatter(content) {
+    const match = content.match(/^---\s*\n[\s\S]*?\n---\s*\n?/);
+    return match ? content.slice(match[0].length).trim() : content.trim();
+}
 /**
  * Format skills for inclusion in a system prompt.
  * Identical to the library's formatSkillsForPrompt except it references
  * `skill_read` instead of `read` so agents denied group:fs can still
  * load skill content.
+ *
+ * Skills with `embed: true` metadata have their body content directly
+ * included in the system prompt instead of requiring `skill_read`.
  */
-function formatSkillsForPromptTaskmaster(skills) {
-    const visibleSkills = skills.filter((s) => !s.disableModelInvocation);
-    if (visibleSkills.length === 0)
+function formatSkillsForPromptTaskmaster(entries) {
+    const visibleEntries = entries.filter((e) => !e.skill.disableModelInvocation);
+    if (visibleEntries.length === 0)
         return "";
-    const lines = [
-        "\n\nThe following skills provide specialized instructions for specific tasks.",
-        "Use the skill_read tool to load a skill's file when the task matches its description.",
-        "When a skill file references a relative path, resolve it against the skill directory (parent of SKILL.md / dirname of the path) and use that absolute path in tool commands.",
-        "",
-        "<available_skills>",
-    ];
-    for (const skill of visibleSkills) {
-        lines.push("  <skill>");
-        lines.push(`    <name>${escapeXml(skill.name)}</name>`);
-        lines.push(`    <description>${escapeXml(skill.description)}</description>`);
-        lines.push(`    <location>${escapeXml(skill.filePath)}</location>`);
-        lines.push("  </skill>");
+    // Partition into embedded and on-demand skills.
+    const embedded = [];
+    const onDemand = [];
+    for (const entry of visibleEntries) {
+        if (entry.taskmaster?.embed === true) {
+            embedded.push(entry);
+        }
+        else {
+            onDemand.push(entry);
+        }
+    }
+    const sections = [];
+    // Embedded skills: content included directly.
+    for (const entry of embedded) {
+        try {
+            const raw = fs.readFileSync(entry.skill.filePath, "utf-8");
+            const body = stripFrontmatter(raw);
+            if (body) {
+                sections.push(`<embedded_skill name="${escapeXml(entry.skill.name)}" location="${escapeXml(entry.skill.filePath)}">\n${body}\n</embedded_skill>`);
+            }
+        }
+        catch {
+            // If the file can't be read, fall through to on-demand.
+            onDemand.push(entry);
+        }
     }
-    lines.push("</available_skills>");
-    return lines.join("\n");
+    // On-demand skills: listed for skill_read loading.
+    if (onDemand.length > 0) {
+        const lines = [
+            "\n\nThe following skills provide specialized instructions for specific tasks.",
+            "Use the skill_read tool to load a skill's file when the task matches its description.",
+            "When a skill file references a relative path, resolve it against the skill directory (parent of SKILL.md / dirname of the path) and use that absolute path in tool commands.",
+            "",
+            "<available_skills>",
+        ];
+        for (const entry of onDemand) {
+            lines.push("  <skill>");
+            lines.push(`    <name>${escapeXml(entry.skill.name)}</name>`);
+            lines.push(`    <description>${escapeXml(entry.skill.description)}</description>`);
+            lines.push(`    <location>${escapeXml(entry.skill.filePath)}</location>`);
+            lines.push("  </skill>");
+        }
+        lines.push("</available_skills>");
+        sections.push(lines.join("\n"));
+    }
+    return sections.join("\n\n");
 }
 const skillCommandDebugOnce = new Set();
 function debugSkillCommandOnce(messageKey, message, meta) {
@@ -176,7 +217,7 @@ export function buildWorkspaceSkillSnapshot(workspaceDir, opts) {
     const promptEntries = eligible.filter((entry) => entry.invocation?.disableModelInvocation !== true);
     const resolvedSkills = promptEntries.map((entry) => entry.skill);
     const remoteNote = opts?.eligibility?.remote?.note?.trim();
-    const prompt = [remoteNote, formatSkillsForPromptTaskmaster(resolvedSkills)]
+    const prompt = [remoteNote, formatSkillsForPromptTaskmaster(promptEntries)]
         .filter(Boolean)
         .join("\n");
     return {
@@ -194,9 +235,7 @@ export function buildWorkspaceSkillsPrompt(workspaceDir, opts) {
     const eligible = filterSkillEntries(skillEntries, opts?.config, opts?.skillFilter, opts?.eligibility);
     const promptEntries = eligible.filter((entry) => entry.invocation?.disableModelInvocation !== true);
     const remoteNote = opts?.eligibility?.remote?.note?.trim();
-    return [remoteNote, formatSkillsForPromptTaskmaster(promptEntries.map((entry) => entry.skill))]
-        .filter(Boolean)
-        .join("\n");
+    return [remoteNote, formatSkillsForPromptTaskmaster(promptEntries)].filter(Boolean).join("\n");
 }
 export function resolveSkillsPromptForRun(params) {
     const snapshotPrompt = params.skillsSnapshot?.prompt?.trim();
@@ -264,6 +303,9 @@ const FORCE_RESYNC_SKILLS = new Set([
     // v1.11.2: brevo skill updated with SMS credits reference; twilio scoped to voice-call only
     "brevo",
     "twilio",
+    // v1.14: sales-closer and business-assistant updated with embed:true
+    "sales-closer",
+    "business-assistant",
 ]);
 /**
  * Copy bundled skills into a workspace's `skills/` directory.

package/dist/agents/system-prompt.js

@@ -27,7 +27,7 @@ function buildMemorySection(params) {
     return [
         "## Memory Recall",
         "Memory is your knowledge base — customer profiles, business data, preferences, prior interactions, lessons, and instructions all live there. Proactively use memory_search whenever a topic might have stored context: who a person is, what was discussed before, business rules, pricing, product details, or anything that could have been recorded. Do not rely on conversation history alone — it only covers the current session. Use memory_get to pull specific lines when you know the file. If a search returns no results, say you checked.",
-        "When skill files or workspace docs reference paths under `memory/` (e.g. `memory/public/data.md`), always access them with memory_get or memory_search — strip the leading `memory/` prefix to get the relative path (e.g. `public/data.md`). Never use read or skill_read for memory content.",
+        "Paths for memory_get and memory_write accept either form: `memory/public/data.md` or `public/data.md` — the `memory/` prefix is added automatically when missing. Never use read or skill_read for memory content.",
         "",
     ];
 }

package/dist/agents/taskmaster-tools.js

@@ -6,6 +6,7 @@ import { createCanvasTool } from "./tools/canvas-tool.js";
 import { createCronTool } from "./tools/cron-tool.js";
 import { createDocumentTool } from "./tools/document-tool.js";
 import { createDocumentToPdfTool } from "./tools/document-to-pdf-tool.js";
+import { createQrGenerateTool } from "./tools/qr-generate-tool.js";
 import { createGatewayTool } from "./tools/gateway-tool.js";
 import { createImageTool } from "./tools/image-tool.js";
 import { createMemoryGetTool, createMemorySaveMediaTool, createMemorySearchTool, createMemoryWriteTool, } from "./tools/memory-tool.js";
@@ -148,16 +149,17 @@ export function createTaskmasterTools(options) {
             agentSessionKey: options?.agentSessionKey,
             sandboxRoot: options?.sandboxRoot,
         }),
+        createQrGenerateTool(),
         createCurrentTimeTool({ config: options?.config }),
         createAuthorizeAdminTool({ agentAccountId: options?.agentAccountId }),
         createRevokeAdminTool({ agentAccountId: options?.agentAccountId }),
         createListAdminsTool({ agentAccountId: options?.agentAccountId }),
         createBootstrapCompleteTool({ agentSessionKey: options?.agentSessionKey }),
         createLicenseGenerateTool(),
-        createContactCreateTool(),
-        createContactDeleteTool(),
-        createContactLookupTool(),
-        createContactUpdateTool(),
+        createContactCreateTool({ agentAccountId: options?.agentAccountId }),
+        createContactDeleteTool({ agentAccountId: options?.agentAccountId }),
+        createContactLookupTool({ agentAccountId: options?.agentAccountId }),
+        createContactUpdateTool({ agentAccountId: options?.agentAccountId }),
         createVerifyContactTool({ agentSessionKey: options?.agentSessionKey }),
         createVerifyContactCodeTool({ agentSessionKey: options?.agentSessionKey }),
         createRelayMessageTool(),

package/dist/agents/tool-policy.js

@@ -15,7 +15,7 @@ export const TOOL_GROUPS = {
         "message_history",
         "document_read",
     ],
-    "group:documents": ["document_read", "document_to_pdf"],
+    "group:documents": ["document_read", "document_to_pdf", "qr_generate"],
     "group:web": ["web_search", "web_fetch"],
     // Time/date utilities
     "group:time": ["current_time"],
@@ -76,6 +76,7 @@ export const TOOL_GROUPS = {
         "message_history",
         "document_read",
         "document_to_pdf",
+        "qr_generate",
         "web_search",
         "web_fetch",
         "image",

package/dist/agents/tools/contact-create-tool.js

@@ -20,7 +20,8 @@ const ContactCreateSchema = Type.Object({
  * are the canonical identifiers that link to user-scoped memory at
  * `memory/users/{phone}/`.
  */
-export function createContactCreateTool() {
+export function createContactCreateTool(opts) {
+    const workspace = opts?.agentAccountId;
     return {
         label: "Contact Create",
         name: "contact_create",
@@ -42,13 +43,13 @@ export function createContactCreateTool() {
             if (!name) {
                 return jsonResult({ error: "Name is required." });
             }
-            const existing = getRecord(phone);
+            const existing = getRecord(phone, workspace);
             if (existing) {
                 return jsonResult({
                     error: `A contact record already exists for ${phone} (${existing.name}). Use contact_update to modify it.`,
                 });
             }
-            const record = setRecord(phone, { name, fields });
+            const record = setRecord(phone, { name, fields, workspace });
             return jsonResult({
                 ok: true,
                 action: "created",

package/dist/agents/tools/contact-delete-tool.js

@@ -13,7 +13,8 @@ const ContactDeleteSchema = Type.Object({
  * Does NOT delete associated user-scoped memory at `memory/users/{phone}/` —
  * that is a separate decision for the business owner.
  */
-export function createContactDeleteTool() {
+export function createContactDeleteTool(opts) {
+    const workspace = opts?.agentAccountId;
     return {
         label: "Contact Delete",
         name: "contact_delete",
@@ -27,7 +28,7 @@ export function createContactDeleteTool() {
             if (!phone) {
                 return jsonResult({ error: "Phone number is required." });
             }
-            const existing = getRecord(phone);
+            const existing = getRecord(phone, workspace);
             if (!existing) {
                 return jsonResult({
                     error: `No contact record found for ${phone}.`,

package/dist/agents/tools/contact-lookup-tool.js

@@ -9,7 +9,8 @@ const ContactLookupSchema = Type.Object({
         description: "Name to search for (partial match).",
     })),
 });
-export function createContactLookupTool() {
+export function createContactLookupTool(opts) {
+    const workspace = opts?.agentAccountId;
     return {
         label: "Contact Lookup",
         name: "contact_lookup",
@@ -22,20 +23,20 @@ export function createContactLookupTool() {
             const phone = typeof params.phone === "string" ? params.phone.trim() : undefined;
             const name = typeof params.name === "string" ? params.name.trim() : undefined;
             if (!phone && !name) {
-                const all = listRecords();
+                const all = listRecords(workspace);
                 if (all.length === 0) {
                     return jsonResult({ found: false, message: "No contact records exist yet." });
                 }
                 return jsonResult({ found: true, count: all.length, records: all });
             }
             if (phone) {
-                const record = getRecord(phone);
+                const record = getRecord(phone, workspace);
                 if (!record) {
                     return jsonResult({ found: false, message: `No record found for ${phone}.` });
                 }
                 return jsonResult({ found: true, record });
             }
-            const results = searchRecords(name);
+            const results = searchRecords(name, workspace);
             if (results.length === 0) {
                 return jsonResult({ found: false, message: `No records matching "${name}".` });
             }

package/dist/agents/tools/contact-update-tool.js

@@ -20,7 +20,8 @@ const ContactUpdateSchema = Type.Object({
  * The public agent does NOT have access to this tool (same gating as
  * license_generate — not in any profile allow list).
  */
-export function createContactUpdateTool() {
+export function createContactUpdateTool(opts) {
+    const workspace = opts?.agentAccountId;
     return {
         label: "Contact Update",
         name: "contact_update",
@@ -39,7 +40,7 @@ export function createContactUpdateTool() {
             if (!field) {
                 return jsonResult({ error: "Field name is required." });
             }
-            const existing = getRecord(phone);
+            const existing = getRecord(phone, workspace);
             if (!existing) {
                 return jsonResult({
                     error: `No contact record found for ${phone}. Create one via the Contacts admin page first.`,
@@ -48,7 +49,9 @@ export function createContactUpdateTool() {
             // "name" updates the contact's canonical display name, not a custom field.
             if (field === "name") {
                 if (value === undefined) {
-                    return jsonResult({ error: "Cannot delete the contact name. Provide a new value instead." });
+                    return jsonResult({
+                        error: "Cannot delete the contact name. Provide a new value instead.",
+                    });
                 }
                 const updated = setRecordName(phone, value);
                 return jsonResult({

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

@@ -9,7 +9,9 @@ const MemorySearchSchema = Type.Object({
     minScore: Type.Optional(Type.Number()),
 });
 const MemoryGetSchema = Type.Object({
-    path: Type.String(),
+    path: Type.String({
+        description: 'Path within memory, e.g. "memory/public/data.md" or "public/data.md"',
+    }),
     from: Type.Optional(Type.Number()),
     lines: Type.Optional(Type.Number()),
 });

package/dist/agents/tools/qr-generate-tool.js

@@ -0,0 +1,45 @@
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { Type } from "@sinclair/typebox";
+import { renderQrPngBase64 } from "../../web/qr-image.js";
+import { jsonResult, readStringParam } from "./common.js";
+const QrGenerateSchema = Type.Object({
+    data: Type.String({
+        description: "The content to encode as a QR code. Pass the final string directly: " +
+            "a URL, plain text, a vCard block, or a wa.me deep link.",
+    }),
+});
+export function createQrGenerateTool() {
+    return {
+        label: "QR Code Generator",
+        name: "qr_generate",
+        description: "Generate a QR code PNG from any string (URL, text, vCard, WhatsApp link). " +
+            "Returns a MEDIA: path — copy it into the message tool's media parameter to send the image.",
+        parameters: QrGenerateSchema,
+        execute: async (_toolCallId, params) => {
+            const data = readStringParam(params, "data");
+            if (!data) {
+                return jsonResult({ ok: false, error: "data is empty — provide the content to encode" });
+            }
+            try {
+                const base64 = await renderQrPngBase64(data);
+                const buf = Buffer.from(base64, "base64");
+                const filename = `qr-${Date.now()}.png`;
+                const pngPath = path.join(os.tmpdir(), filename);
+                await fs.writeFile(pngPath, buf);
+                return {
+                    content: [
+                        { type: "text", text: `MEDIA:${pngPath}` },
+                        { type: "text", text: JSON.stringify({ ok: true, path: pngPath }) },
+                    ],
+                    details: { ok: true, path: pngPath },
+                };
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return jsonResult({ ok: false, error: `QR generation failed: ${message}` });
+            }
+        },
+    };
+}