maestro-agent-sdk 0.1.3 → 0.1.5

package/dist/tools/builtin/todo_write.js

@@ -1,96 +0,0 @@
-export function createTodoWriteTool(opts) {
-    const { store } = opts;
-    return {
-        parallelSafe: false,
-        schema: {
-            name: "todo_write",
-            description: "Write the current task list. Pass the COMPLETE snapshot of what you want the list " +
-                "to look like — entries with an existing `id` are updated, new entries (id omitted) " +
-                "get an auto-assigned id (task-N), and entries absent from the snapshot are dropped. " +
-                "At most one entry may have status `in_progress`; if you mark more than one, the LAST " +
-                "in_progress wins and the others are flipped to `pending`. The current list is " +
-                "surfaced to you in the system reminder each turn — call this whenever a multi-step " +
-                "plan starts, mid-flight when a step finishes, or to add/drop items.",
-            input_schema: {
-                type: "object",
-                properties: {
-                    todos: {
-                        type: "array",
-                        description: "Complete snapshot of the task list. Each item: " +
-                            "{id?: string, content: string, status: 'pending'|'in_progress'|'completed', " +
-                            "activeForm?: string}. Include EVERY task you want to keep — omitting one drops it.",
-                    },
-                },
-                required: ["todos"],
-            },
-        },
-        async execute(input) {
-            const raw = input.todos;
-            if (!Array.isArray(raw)) {
-                return JSON.stringify({
-                    error: "todo_write: 'todos' must be an array",
-                });
-            }
-            const incoming = [];
-            for (let i = 0; i < raw.length; i++) {
-                const item = raw[i];
-                if (!item || typeof item !== "object") {
-                    return JSON.stringify({
-                        error: `todo_write: todos[${i}] must be an object`,
-                    });
-                }
-                const obj = item;
-                const content = obj.content;
-                const status = obj.status;
-                if (typeof content !== "string" || content.length === 0) {
-                    return JSON.stringify({
-                        error: `todo_write: todos[${i}].content must be a non-empty string`,
-                    });
-                }
-                if (status !== "pending" && status !== "in_progress" && status !== "completed") {
-                    return JSON.stringify({
-                        error: `todo_write: todos[${i}].status must be 'pending', 'in_progress', or 'completed'`,
-                    });
-                }
-                const upsert = { content, status };
-                if (typeof obj.id === "string" && obj.id.length > 0)
-                    upsert.id = obj.id;
-                if (typeof obj.activeForm === "string" && obj.activeForm.length > 0) {
-                    upsert.activeForm = obj.activeForm;
-                }
-                incoming.push(upsert);
-            }
-            const result = store.upsert(incoming);
-            const summary = summarize(result.todos);
-            const parts = [
-                `Task list updated (${result.todos.length} item${result.todos.length === 1 ? "" : "s"}).`,
-                summary,
-            ];
-            if (result.demotedId) {
-                parts.push(`Note: more than one item was marked in_progress; '${result.demotedId}' was flipped to pending so only the last in_progress entry stays active.`);
-            }
-            return parts.join("\n\n");
-        },
-    };
-}
-/**
- * Render a compact ascii summary of the list. Used in the tool result so
- * the model immediately sees what landed (mirrors how Edit returns a
- * preview after a successful write).
- *
- * Format:
- *   [✓] task-1  Done thing here
- *   [→] task-2  In-flight thing
- *   [ ] task-3  Pending thing
- */
-function summarize(todos) {
-    if (todos.length === 0)
-        return "(list is empty)";
-    return todos
-        .map((t) => {
-        const mark = t.status === "completed" ? "✓" : t.status === "in_progress" ? "→" : " ";
-        return `[${mark}] ${t.id}  ${t.content}`;
-    })
-        .join("\n");
-}
-//# sourceMappingURL=todo_write.js.map

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

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

package/dist/tools/hooks/sandbox-fs.d.ts

@@ -1,25 +0,0 @@
-import type { HookRegistration } from "../../tools/registry.js";
-/**
- * Filesystem sandbox as a PreToolUse hook.
- *
- * Centralized opt-in gate for any tool whose input carries a `file_path`
- * argument (Read/Write/Edit today, future FS-touching MCP tools by
- * inheritance). Default is **disabled** to match the unconstrained FS
- * posture of claude (`bypassPermissions`) and codex (`danger-full-access`)
- * providers — divergence here used to silently break maestro-only workflows
- * that legitimately reach outside the workspace. Operator opts in by
- * exporting `MAESTRO_FS_SANDBOX_ENABLED=1`.
- *
- * Scope: only tools whose `input.file_path` is a non-empty string are
- * inspected. Tools that don't surface a file path (bash, web_fetch, MCP
- * tools without an FS argument) are unaffected — this hook is FS-specific
- * by design. A future bash-sandbox hook would be a separate registration.
- *
- * Absolute-path enforcement is left to the tool itself: the model's error
- * message is clearer when it comes from the tool (`Read: file_path must be
- * absolute`) than from the sandbox hook ("path is not absolute"). The
- * sandbox only weighs in once an absolute path has been confirmed —
- * mirroring how the inline check used to work.
- */
-export declare function createSandboxFsHook(): HookRegistration;
-//# sourceMappingURL=sandbox-fs.d.ts.map

package/dist/tools/hooks/sandbox-fs.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sandbox-fs.d.ts","sourceRoot":"","sources":["../../../src/tools/hooks/sandbox-fs.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,CAsBtD"}

package/dist/tools/hooks/sandbox-fs.js

@@ -1,48 +0,0 @@
-import { isAbsolute } from "node:path";
-import { checkFilesystemAccess, isSandboxEnabled } from "../../tools/builtin/sandbox.js";
-/**
- * Filesystem sandbox as a PreToolUse hook.
- *
- * Centralized opt-in gate for any tool whose input carries a `file_path`
- * argument (Read/Write/Edit today, future FS-touching MCP tools by
- * inheritance). Default is **disabled** to match the unconstrained FS
- * posture of claude (`bypassPermissions`) and codex (`danger-full-access`)
- * providers — divergence here used to silently break maestro-only workflows
- * that legitimately reach outside the workspace. Operator opts in by
- * exporting `MAESTRO_FS_SANDBOX_ENABLED=1`.
- *
- * Scope: only tools whose `input.file_path` is a non-empty string are
- * inspected. Tools that don't surface a file path (bash, web_fetch, MCP
- * tools without an FS argument) are unaffected — this hook is FS-specific
- * by design. A future bash-sandbox hook would be a separate registration.
- *
- * Absolute-path enforcement is left to the tool itself: the model's error
- * message is clearer when it comes from the tool (`Read: file_path must be
- * absolute`) than from the sandbox hook ("path is not absolute"). The
- * sandbox only weighs in once an absolute path has been confirmed —
- * mirroring how the inline check used to work.
- */
-export function createSandboxFsHook() {
-    return {
-        name: "sandbox-fs",
-        pre(ctx) {
-            // Cheap exit when the operator hasn't opted into the sandbox — the
-            // common case, so skip the work before doing any property reads.
-            if (!isSandboxEnabled())
-                return { decision: "allow" };
-            const filePath = ctx.input.file_path;
-            if (typeof filePath !== "string" || filePath.length === 0) {
-                return { decision: "allow" };
-            }
-            // Defer absolute-path errors to the tool — its message is clearer.
-            if (!isAbsolute(filePath))
-                return { decision: "allow" };
-            const err = checkFilesystemAccess(filePath);
-            if (err) {
-                return { decision: "block", error: `${ctx.toolName}: ${err}` };
-            }
-            return { decision: "allow" };
-        },
-    };
-}
-//# sourceMappingURL=sandbox-fs.js.map

package/dist/tools/hooks/sandbox-fs.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sandbox-fs.js","sourceRoot":"","sources":["../../../src/tools/hooks/sandbox-fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGlF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,GAAG,CAAC,GAAG;YACL,mEAAmE;YACnE,iEAAiE;YACjE,IAAI,CAAC,gBAAgB,EAAE;gBAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;YAEtD,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC;YACrC,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1D,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;YAC/B,CAAC;YACD,mEAAmE;YACnE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;gBAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;YAExD,MAAM,GAAG,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;YAC5C,IAAI,GAAG,EAAE,CAAC;gBACR,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,QAAQ,KAAK,GAAG,EAAE,EAAE,CAAC;YACjE,CAAC;YACD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QAC/B,CAAC;KACF,CAAC;AACJ,CAAC"}