maestro-agent-sdk 0.1.4 → 0.1.6

package/dist/tools/builtin/skill_write.js

@@ -0,0 +1,264 @@
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { dirname, isAbsolute, join, normalize, relative } from "node:path";
+import { invalidateSkillsCache } from "../../skills/loader.js";
+import { logger } from "../../platform/logger.js";
+/** kebab-case validator: lowercase letters, digits, dashes. Must start with
+ *  a letter; no leading/trailing/consecutive dashes. */
+const NAME_RE = /^[a-z](?:[a-z0-9]|-(?=[a-z0-9]))*$/;
+/** Soft sanity check — the loader will surface the skill regardless, but
+ *  warning the agent here helps it land a clawgram-conformant file on the
+ *  first try. */
+function lintContent(content) {
+    const warnings = [];
+    if (!/^#\s+\S/m.test(content)) {
+        warnings.push("Missing a top-level `# Title` heading.");
+    }
+    if (!/^[ \t]*>[ \t]*(?:\*\*)?\s*description\s*(?:\*\*)?[ \t]*:/im.test(content)) {
+        warnings.push("Missing a `> **Description**: ...` blockquote — trigger keywords " +
+            "won't surface in the system-prompt index until you add one.");
+    }
+    return { warnings };
+}
+export function createSkillWriteTool(opts) {
+    const { skillsDir } = opts;
+    return {
+        // Writes mutate disk + invalidate cache — not safe for parallel
+        // dispatch with another skill_write (two writes racing the cache
+        // invalidation could leave a stale entry). Reads are fine to overlap
+        // because the cache TTL absorbs the staleness.
+        parallelSafe: false,
+        schema: {
+            name: "skill_write",
+            description: "Author or update a skill manifest (and optional adjacent assets) " +
+                "inside the session's skills directory. Writes " +
+                "`<skillsDir>/<name>/skill.md` with the provided markdown content, " +
+                "plus any files listed in `files` under the same skill folder " +
+                "(e.g. `scripts/foo.py`, `templates/x.tex`, `references/api.md`). " +
+                "Folder layout is mandatory — progressive-disclosure assets sit " +
+                "next to the manifest. The catalog reloads on the NEXT turn " +
+                "(not the current one) — finish your current task, then the new " +
+                "skill is available via skill_view.\n\n" +
+                "Content conventions (clawgram-style):\n" +
+                "  - First line: `# Title` (the display title; can be Korean or English).\n" +
+                "  - Near the top: `> **Description**: <comma-separated trigger keywords>`. " +
+                "This drives skill activation — be specific, list the words a user would " +
+                "actually type.\n" +
+                "  - Sections to include: 트리거 / 프로세스 / Gotchas. Gotchas is the " +
+                "most valuable section — accumulate failure cases + fixes over time.\n" +
+                "  - Don't restate the obvious; focus on knowledge that changes behavior.\n\n" +
+                "Returns success with the manifest path + per-asset paths, or an " +
+                "error JSON when validation fails or any target already exists " +
+                "(pass `overwrite: true` to replace).",
+            input_schema: {
+                type: "object",
+                properties: {
+                    name: {
+                        type: "string",
+                        description: "Skill identifier in kebab-case (lowercase, dashes between words, " +
+                            "no leading/trailing dashes). Becomes the folder name; the loader " +
+                            "uses it as the canonical name when no frontmatter `name:` is set.",
+                    },
+                    content: {
+                        type: "string",
+                        description: "Full markdown body of the skill. Must include `# Title` and " +
+                            "`> **Description**: ...` near the top (a warning surfaces if either " +
+                            "is missing). No YAML frontmatter required.",
+                    },
+                    files: {
+                        type: "object",
+                        description: "Optional map of `<relative-path>: <file-content>` for adjacent " +
+                            "assets inside the skill folder. Paths are relative to " +
+                            "`<skillsDir>/<name>/`, use forward slashes, must not contain `..` " +
+                            "or absolute prefixes, and cannot equal `skill.md` (reserved for " +
+                            "the manifest). Parent directories are created automatically. " +
+                            "Example: `{\"scripts/run.sh\": \"#!/bin/bash\\n...\", " +
+                            "\"templates/x.tex\": \"...\", \"references/api.md\": \"...\"}`",
+                        additionalProperties: { type: "string" },
+                    },
+                    overwrite: {
+                        type: "boolean",
+                        description: "Replace existing files at the manifest path OR any `files` " +
+                            "target. Default false; when false, any preexisting target aborts " +
+                            "the whole call BEFORE writing anything.",
+                    },
+                },
+                required: ["name", "content"],
+            },
+        },
+        async execute(input) {
+            const name = typeof input.name === "string" ? input.name.trim() : "";
+            const content = typeof input.content === "string" ? input.content : "";
+            const overwrite = input.overwrite === true;
+            const filesInput = input.files && typeof input.files === "object" && !Array.isArray(input.files)
+                ? input.files
+                : null;
+            if (!name) {
+                return JSON.stringify({ error: "skill_write: missing 'name' argument" });
+            }
+            if (!NAME_RE.test(name)) {
+                return JSON.stringify({
+                    error: `skill_write: invalid name '${name}' — must be kebab-case ` +
+                        "(lowercase letters/digits, single dashes between segments, " +
+                        "start with a letter).",
+                });
+            }
+            if (!content.trim()) {
+                return JSON.stringify({
+                    error: "skill_write: 'content' is empty — provide the skill markdown body",
+                });
+            }
+            // Final path: <skillsDir>/<name>/skill.md. The skillsDir was resolved
+            // from (cwd, skillKey) at session start, so the agent's write
+            // automatically lands in its own profile.
+            const skillDir = join(skillsDir, name);
+            const skillFile = join(skillDir, "skill.md");
+            // ---- Phase 1: validate the entire write set BEFORE touching disk ----
+            // Up-front validation lets us reject a malformed batch as a unit
+            // (e.g. one bad relative path among ten files) instead of writing
+            // half the assets and then bailing.
+            const fileWrites = [];
+            if (filesInput) {
+                for (const [rel, raw] of Object.entries(filesInput)) {
+                    if (typeof rel !== "string" || rel.trim() === "") {
+                        return JSON.stringify({
+                            error: `skill_write: 'files' has an empty key (entry value: ${typeof raw})`,
+                        });
+                    }
+                    if (typeof raw !== "string") {
+                        return JSON.stringify({
+                            error: `skill_write: 'files[${rel}]' must be a string, got ${typeof raw}`,
+                        });
+                    }
+                    const safetyErr = validateRelativePath(rel);
+                    if (safetyErr) {
+                        return JSON.stringify({
+                            error: `skill_write: ${safetyErr} (entry '${rel}')`,
+                        });
+                    }
+                    if (rel === "skill.md") {
+                        return JSON.stringify({
+                            error: "skill_write: 'files' may not include 'skill.md' — pass the " +
+                                "manifest body via the top-level `content` argument instead",
+                        });
+                    }
+                    fileWrites.push({ rel, abs: join(skillDir, rel), body: raw });
+                }
+            }
+            // Pre-check existing-target conflicts when overwrite=false. We do
+            // this AFTER validating shapes so a malformed entry surfaces first.
+            if (!overwrite) {
+                if (existsSync(skillFile)) {
+                    return JSON.stringify({
+                        error: `skill_write: '${skillFile}' already exists — pass overwrite: true to replace`,
+                        path: skillFile,
+                    });
+                }
+                for (const f of fileWrites) {
+                    if (existsSync(f.abs)) {
+                        return JSON.stringify({
+                            error: `skill_write: '${f.abs}' already exists — pass overwrite: true to replace`,
+                            path: f.abs,
+                            rel: f.rel,
+                        });
+                    }
+                }
+            }
+            // ---- Phase 2: write manifest + adjacent files ----
+            let bytesTotal = 0;
+            const writtenFiles = [];
+            try {
+                mkdirSync(skillDir, { recursive: true });
+                // Manifest first — ensure trailing newline.
+                const manifestBody = content.endsWith("\n") ? content : `${content}\n`;
+                writeFileSync(skillFile, manifestBody, "utf-8");
+                const manifestBytes = Buffer.byteLength(manifestBody, "utf-8");
+                bytesTotal += manifestBytes;
+                for (const f of fileWrites) {
+                    mkdirSync(dirname(f.abs), { recursive: true });
+                    writeFileSync(f.abs, f.body, "utf-8");
+                    const b = Buffer.byteLength(f.body, "utf-8");
+                    bytesTotal += b;
+                    writtenFiles.push({ rel: f.rel, path: f.abs, bytes: b });
+                }
+            }
+            catch (e) {
+                // Partial failure: the manifest may or may not be written, and
+                // some files may have landed. Report what succeeded so the agent
+                // can decide whether to re-try with overwrite or clean up by hand.
+                return JSON.stringify({
+                    error: `skill_write: failed mid-write: ${e instanceof Error ? e.message : String(e)}`,
+                    manifestPath: skillFile,
+                    manifestWritten: existsSync(skillFile),
+                    filesWritten: writtenFiles,
+                });
+            }
+            // Bust the loader cache so the next provider call (next turn) sees
+            // this skill in the catalog without waiting for the TTL.
+            invalidateSkillsCache();
+            const { warnings } = lintContent(content);
+            const result = {
+                ok: true,
+                path: skillFile,
+                skillDir,
+                name,
+                action: overwrite ? "overwritten" : "created",
+                bytes: bytesTotal,
+                note: "Catalog reloads on the NEXT turn — the new skill is not visible " +
+                    "in the current turn's <available_skills> list. Call skill_view " +
+                    "after the next user turn to verify activation.",
+            };
+            if (writtenFiles.length > 0)
+                result.files = writtenFiles;
+            if (warnings.length > 0)
+                result.warnings = warnings;
+            logger.info({
+                name,
+                path: skillFile,
+                action: result.action,
+                bytes: bytesTotal,
+                fileCount: writtenFiles.length,
+                warningCount: warnings.length,
+            }, "skill_write: skill manifest + assets persisted");
+            return JSON.stringify(result);
+        },
+    };
+}
+/**
+ * Validate a relative path supplied via `files`. Returns an error string on
+ * failure, or `null` when the path is safe to use as `join(skillDir, rel)`.
+ *
+ * Rejected:
+ *  - absolute paths (any drive prefix or leading `/`)
+ *  - paths that normalize outside the skill folder (`..` escapes)
+ *  - paths that resolve to "." (i.e. the skill folder itself)
+ *  - paths with backslashes (force forward-slash to keep cross-platform
+ *    behavior predictable; Windows hosts will translate on `join`)
+ *
+ * Note: we don't validate against a per-file regex — the model can write
+ * any filename the host filesystem accepts, including dotfiles. Only the
+ * traversal vector is the safety boundary.
+ */
+function validateRelativePath(rel) {
+    if (rel.includes("\\")) {
+        return `path '${rel}' must use forward slashes, not backslashes`;
+    }
+    if (isAbsolute(rel)) {
+        return `path '${rel}' must be relative to the skill folder, not absolute`;
+    }
+    const normalized = normalize(rel);
+    if (normalized === "." || normalized === "") {
+        return `path '${rel}' resolves to the skill folder itself`;
+    }
+    // The reliable cross-platform escape check: a `..` segment anywhere.
+    const segments = normalized.split(/[/\\]/);
+    if (segments.includes("..")) {
+        return `path '${rel}' escapes the skill folder via '..'`;
+    }
+    // Defensive: ensure relative() from "." still keeps us inside.
+    const back = relative(".", normalized);
+    if (back.startsWith("..")) {
+        return `path '${rel}' escapes the skill folder via '..'`;
+    }
+    return null;
+}
+//# sourceMappingURL=skill_write.js.map

package/dist/tools/builtin/skill_write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill_write.js","sourceRoot":"","sources":["../../../src/tools/builtin/skill_write.ts"],"names":[],"mappings":"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"}

package/dist/tools/builtin/tasks.d.ts

@@ -0,0 +1,34 @@
+import type { TaskStore } from "../../state/tasks.js";
+import type { ToolHandler } from "../../tools/registry.js";
+/**
+ * `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` builtins — the
+ * granular replacement for the v0.1.x `todo_write` snapshot-replace tool.
+ *
+ * Each tool covers a single CRUD verb so the model can mutate one task per
+ * call without round-tripping the whole list. The store enforces a single
+ * `in_progress` task at a time (TaskUpdate flips any prior in_progress to
+ * pending and surfaces the demoted id), and dependency edges
+ * (`blockedBy` / `blocks`) are kept bidirectionally consistent.
+ *
+ * The read side stays cheap: every per-turn `<system-reminder>` already
+ * renders the current list. `TaskList` exists for explicit refresh after
+ * a long stretch of tool work (sub-agent delegation, batch updates), and
+ * `TaskGet` returns the full entry — including description, owner, and
+ * metadata — which the reminder summary intentionally omits.
+ *
+ * Side-effecting tools (`TaskCreate`, `TaskUpdate`) are `parallelSafe: false`
+ * because two concurrent writes would race on the in-progress sweep and
+ * dependency-edge maintenance. Reads (`TaskList`, `TaskGet`) are safe to
+ * parallelise — they snapshot the in-memory map.
+ */
+export interface TaskToolsOptions {
+    /** Required. The per-session store. Built by maestroProvider via
+     *  `getTaskStore(sessionId)` so the same instance is shared across
+     *  every tool call in this turn. */
+    store: TaskStore;
+}
+export declare function createTaskCreateTool(opts: TaskToolsOptions): ToolHandler;
+export declare function createTaskUpdateTool(opts: TaskToolsOptions): ToolHandler;
+export declare function createTaskListTool(opts: TaskToolsOptions): ToolHandler;
+export declare function createTaskGetTool(opts: TaskToolsOptions): ToolHandler;
+//# sourceMappingURL=tasks.d.ts.map

package/dist/tools/builtin/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,SAAS,EAEV,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,gBAAgB;IAC/B;;wCAEoC;IACpC,KAAK,EAAE,SAAS,CAAC;CAClB;AA+BD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,GAAG,WAAW,CAgExE;AAQD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,GAAG,WAAW,CAsGxE;AAMD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,WAAW,CAiCtE;AAMD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,GAAG,WAAW,CAiCrE"}

package/dist/tools/builtin/tasks.js

@@ -0,0 +1,258 @@
+function summarize(t) {
+    const out = {
+        id: t.id,
+        subject: t.subject,
+        status: t.status,
+        blockedBy: t.blockedBy,
+        blocks: t.blocks,
+    };
+    if (t.activeForm)
+        out.activeForm = t.activeForm;
+    if (t.owner)
+        out.owner = t.owner;
+    return out;
+}
+// ---------------------------------------------------------------------------
+// TaskCreate
+// ---------------------------------------------------------------------------
+export function createTaskCreateTool(opts) {
+    const { store } = opts;
+    return {
+        parallelSafe: false,
+        schema: {
+            name: "TaskCreate",
+            description: "Create a single new task. Returns the freshly assigned id (numeric " +
+                "string like '1', '2', ...). The task starts in 'pending' status — " +
+                "transition it with TaskUpdate. Set up dependencies via TaskUpdate's " +
+                "`addBlockedBy` / `addBlocks` fields after the dependent tasks exist.",
+            input_schema: {
+                type: "object",
+                properties: {
+                    subject: {
+                        type: "string",
+                        description: "Imperative title — what needs to be done. e.g. 'Read spec'.",
+                    },
+                    description: {
+                        type: "string",
+                        description: "Optional longer detail or acceptance criteria. Use this for context " +
+                            "the subject line is too short to carry.",
+                    },
+                    activeForm: {
+                        type: "string",
+                        description: "Optional present-continuous form for spinner/status display " +
+                            "('Reading spec' vs the imperative 'Read spec'). Hosts that " +
+                            "render a live task list show this while status is in_progress.",
+                    },
+                    owner: {
+                        type: "string",
+                        description: "Optional owner / agent name. Useful when delegating to sub-agents " +
+                            "via the Agent tool so a glance at TaskList shows who's responsible.",
+                    },
+                    metadata: {
+                        type: "object",
+                        description: "Arbitrary host-controlled bag, round-tripped verbatim. The SDK " +
+                            "neither reads nor interprets the shape.",
+                        additionalProperties: true,
+                    },
+                },
+                required: ["subject"],
+            },
+        },
+        async execute(input) {
+            const subject = typeof input.subject === "string" ? input.subject.trim() : "";
+            if (!subject) {
+                return JSON.stringify({ error: "TaskCreate: 'subject' must be a non-empty string" });
+            }
+            const create = { subject };
+            if (typeof input.description === "string")
+                create.description = input.description;
+            if (typeof input.activeForm === "string")
+                create.activeForm = input.activeForm;
+            if (typeof input.owner === "string")
+                create.owner = input.owner;
+            if (input.metadata && typeof input.metadata === "object" && !Array.isArray(input.metadata)) {
+                create.metadata = input.metadata;
+            }
+            const entry = store.create(create);
+            return JSON.stringify({ ok: true, id: entry.id, subject: entry.subject });
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// TaskUpdate
+// ---------------------------------------------------------------------------
+const VALID_STATUSES = new Set(["pending", "in_progress", "completed", "deleted"]);
+export function createTaskUpdateTool(opts) {
+    const { store } = opts;
+    return {
+        parallelSafe: false,
+        schema: {
+            name: "TaskUpdate",
+            description: "Update a single existing task by id. Any subset of fields can change " +
+                "in one call (status, subject, description, activeForm, owner, " +
+                "metadata, dependency edges). Status transitions:\n" +
+                "  - → 'in_progress': the store demotes any other in_progress task to " +
+                "'pending' (1-in-progress invariant) and reports the demoted id back.\n" +
+                "  - → 'deleted': permanent. The task disappears from TaskList output " +
+                "but stays on disk for TaskGet forensics.\n" +
+                "Dependency edges are bidirectional — addBlockedBy: ['3'] on task 5 " +
+                "also adds '5' to task 3's blocks list. Self-loops and unknown ids " +
+                "are silently ignored.",
+            input_schema: {
+                type: "object",
+                properties: {
+                    taskId: {
+                        type: "string",
+                        description: "Id of the task to mutate (as returned by TaskCreate).",
+                    },
+                    status: {
+                        type: "string",
+                        enum: ["pending", "in_progress", "completed", "deleted"],
+                        description: "New status. Setting in_progress triggers the 1-in-progress sweep; " +
+                            "setting deleted is permanent.",
+                    },
+                    subject: { type: "string", description: "New imperative title." },
+                    description: { type: "string", description: "New long-form detail." },
+                    activeForm: { type: "string", description: "New spinner / status display form." },
+                    owner: { type: "string", description: "New owner / agent name." },
+                    metadata: {
+                        type: "object",
+                        description: "New metadata bag (overwrites previous).",
+                        additionalProperties: true,
+                    },
+                    addBlockedBy: {
+                        type: "array",
+                        items: { type: "string" },
+                        description: "Task ids that must complete before this one can start. Edges " +
+                            "are added bidirectionally on the blockers' `blocks` lists.",
+                    },
+                    addBlocks: {
+                        type: "array",
+                        items: { type: "string" },
+                        description: "Task ids that this task blocks. Edges are added bidirectionally " +
+                            "on the blocked tasks' `blockedBy` lists.",
+                    },
+                },
+                required: ["taskId"],
+            },
+        },
+        async execute(input) {
+            const taskId = typeof input.taskId === "string" ? input.taskId.trim() : "";
+            if (!taskId) {
+                return JSON.stringify({ error: "TaskUpdate: 'taskId' must be a non-empty string" });
+            }
+            if (!store.get(taskId)) {
+                return JSON.stringify({ error: `TaskUpdate: no task with id '${taskId}'` });
+            }
+            const update = {};
+            if (typeof input.status === "string") {
+                if (!VALID_STATUSES.has(input.status)) {
+                    return JSON.stringify({
+                        error: `TaskUpdate: invalid status '${input.status}' — must be one of ` +
+                            "pending, in_progress, completed, deleted",
+                    });
+                }
+                update.status = input.status;
+            }
+            if (typeof input.subject === "string" && input.subject.trim()) {
+                update.subject = input.subject;
+            }
+            if (typeof input.description === "string")
+                update.description = input.description;
+            if (typeof input.activeForm === "string")
+                update.activeForm = input.activeForm;
+            if (typeof input.owner === "string")
+                update.owner = input.owner;
+            if (input.metadata && typeof input.metadata === "object" && !Array.isArray(input.metadata)) {
+                update.metadata = input.metadata;
+            }
+            if (Array.isArray(input.addBlockedBy)) {
+                update.addBlockedBy = input.addBlockedBy.filter((x) => typeof x === "string");
+            }
+            if (Array.isArray(input.addBlocks)) {
+                update.addBlocks = input.addBlocks.filter((x) => typeof x === "string");
+            }
+            const result = store.update(taskId, update);
+            const payload = {
+                ok: true,
+                task: summarize(result.task),
+            };
+            if (result.demotedId)
+                payload.demotedId = result.demotedId;
+            return JSON.stringify(payload);
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// TaskList
+// ---------------------------------------------------------------------------
+export function createTaskListTool(opts) {
+    const { store } = opts;
+    return {
+        parallelSafe: true,
+        schema: {
+            name: "TaskList",
+            description: "Return all non-deleted tasks (compact form: id, subject, status, " +
+                "activeForm, owner, blockedBy, blocks). The per-turn system reminder " +
+                "already carries a summary — use TaskList when you need the full " +
+                "state programmatically (e.g. after a stretch of TaskUpdate calls " +
+                "or sub-agent delegation). Pass `includeDeleted: true` to also see " +
+                "tasks the model marked deleted earlier.",
+            input_schema: {
+                type: "object",
+                properties: {
+                    includeDeleted: {
+                        type: "boolean",
+                        description: "When true, include tasks with status='deleted'. Default false.",
+                    },
+                },
+            },
+        },
+        async execute(input) {
+            const includeDeleted = input.includeDeleted === true;
+            const list = includeDeleted ? store.listAll() : store.list();
+            return JSON.stringify({
+                ok: true,
+                count: list.length,
+                tasks: list.map(summarize),
+            });
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// TaskGet
+// ---------------------------------------------------------------------------
+export function createTaskGetTool(opts) {
+    const { store } = opts;
+    return {
+        parallelSafe: true,
+        schema: {
+            name: "TaskGet",
+            description: "Fetch the full entry for a single task (every field including " +
+                "description, metadata, createdAt/updatedAt timestamps). Use this " +
+                "when the compact TaskList summary doesn't carry enough detail.",
+            input_schema: {
+                type: "object",
+                properties: {
+                    taskId: {
+                        type: "string",
+                        description: "Id of the task to fetch.",
+                    },
+                },
+                required: ["taskId"],
+            },
+        },
+        async execute(input) {
+            const taskId = typeof input.taskId === "string" ? input.taskId.trim() : "";
+            if (!taskId) {
+                return JSON.stringify({ error: "TaskGet: 'taskId' must be a non-empty string" });
+            }
+            const task = store.get(taskId);
+            if (!task) {
+                return JSON.stringify({ error: `TaskGet: no task with id '${taskId}'` });
+            }
+            return JSON.stringify({ ok: true, task });
+        },
+    };
+}
+//# sourceMappingURL=tasks.js.map

package/dist/tools/builtin/tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../../src/tools/builtin/tasks.ts"],"names":[],"mappings":"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"}