@evalops/maestro 0.10.51 → 0.10.53

package/dist/tools/lazy-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"lazy-registry.js","sourceRoot":"","sources":["../../src/tools/lazy-registry.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentTool } from \"../agent/types.js\";\n\nconst lazyToolLoaders = {\n\tread: async () => (await import(\"./read.js\")).readTool,\n\tlist: async () => (await import(\"./list.js\")).listTool,\n\toracle: async () => (await import(\"./oracle.js\")).oracleTool,\n\tfind: async () => (await import(\"./find.js\")).findTool,\n\textract_document: async () =>\n\t\t(await import(\"./extract-document.js\")).extractDocumentTool,\n\tsearch: async () => (await import(\"./search.js\")).searchTool,\n\tparallel_ripgrep: async () =>\n\t\t(await import(\"./parallel-ripgrep.js\")).parallelRipgrepTool,\n\tdiff: async () => (await import(\"./diff.js\")).diffTool,\n\tbash: async () => (await import(\"./bash.js\")).bashTool,\n\tbackground_tasks: async () =>\n\t\t(await import(\"./background/tool-handler.js\")).backgroundTasksTool,\n\tapply_patch: async () => (await import(\"./apply-patch.js\")).applyPatchTool,\n\tedit: async () => (await import(\"./edit.js\")).editTool,\n\twrite: async () => (await import(\"./write.js\")).writeTool,\n\tnotebook_edit: async () => (await import(\"./notebook.js\")).notebookEditTool,\n\ttodo: async () => (await import(\"./todo.js\")).todoTool,\n\task_user: async () => (await import(\"./ask-user.js\")).askUserTool,\n\twebsearch: async () => (await import(\"./websearch.js\")).websearchTool,\n\tcodesearch: async () => (await import(\"./codesearch.js\")).codesearchTool,\n\twebfetch: async () => (await import(\"./webfetch.js\")).webfetchTool,\n\tstatus: async () => (await import(\"./status.js\")).statusTool,\n\tgh_pr: async () => (await import(\"./gh.js\")).ghPrTool,\n\tgh_issue: async () => (await import(\"./gh.js\")).ghIssueTool,\n\tgh_repo: async () => (await import(\"./gh.js\")).ghRepoTool,\n\tpipeline_search_contacts: async () =>\n\t\t(await import(\"./pipeline.js\")).pipelineSearchContactsTool,\n\tpipeline_search_deals: async () =>\n\t\t(await import(\"./pipeline.js\")).pipelineSearchDealsTool,\n\tpipeline_create_signal: async () =>\n\t\t(await import(\"./pipeline.js\")).pipelineCreateSignalTool,\n\tpipeline_log_activity: async () =>\n\t\t(await import(\"./pipeline.js\")).pipelineLogActivityTool,\n} satisfies Record<string, () => Promise<AgentTool>>;\n\nexport const lazyToolNames = Object.keys(lazyToolLoaders).sort();\n\nexport async function loadFilteredTools(\n\ttoolNames: string[],\n): Promise<AgentTool[]> {\n\tconst filtered: AgentTool[] = [];\n\tfor (const name of toolNames) {\n\t\tconst loadTool = lazyToolLoaders[name as keyof typeof lazyToolLoaders];\n\t\tif (loadTool) {\n\t\t\tfiltered.push(await loadTool());\n\t\t}\n\t}\n\treturn filtered;\n}\n"]}
+{"version":3,"file":"lazy-registry.js","sourceRoot":"","sources":["../../src/tools/lazy-registry.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentTool } from \"../agent/types.js\";\n\nconst lazyToolLoaders = {\n\tread: async () => (await import(\"./read.js\")).readTool,\n\tlist: async () => (await import(\"./list.js\")).listTool,\n\toracle: async () => (await import(\"./oracle.js\")).oracleTool,\n\tpainter: async () => (await import(\"./painter.js\")).painterTool,\n\tfind: async () => (await import(\"./find.js\")).findTool,\n\textract_document: async () =>\n\t\t(await import(\"./extract-document.js\")).extractDocumentTool,\n\tsearch: async () => (await import(\"./search.js\")).searchTool,\n\tparallel_ripgrep: async () =>\n\t\t(await import(\"./parallel-ripgrep.js\")).parallelRipgrepTool,\n\tdiff: async () => (await import(\"./diff.js\")).diffTool,\n\tbash: async () => (await import(\"./bash.js\")).bashTool,\n\tbackground_tasks: async () =>\n\t\t(await import(\"./background/tool-handler.js\")).backgroundTasksTool,\n\tapply_patch: async () => (await import(\"./apply-patch.js\")).applyPatchTool,\n\tedit: async () => (await import(\"./edit.js\")).editTool,\n\twrite: async () => (await import(\"./write.js\")).writeTool,\n\tnotebook_edit: async () => (await import(\"./notebook.js\")).notebookEditTool,\n\ttodo: async () => (await import(\"./todo.js\")).todoTool,\n\task_user: async () => (await import(\"./ask-user.js\")).askUserTool,\n\twebsearch: async () => (await import(\"./websearch.js\")).websearchTool,\n\tcodesearch: async () => (await import(\"./codesearch.js\")).codesearchTool,\n\twebfetch: async () => (await import(\"./webfetch.js\")).webfetchTool,\n\tstatus: async () => (await import(\"./status.js\")).statusTool,\n\tgh_pr: async () => (await import(\"./gh.js\")).ghPrTool,\n\tgh_issue: async () => (await import(\"./gh.js\")).ghIssueTool,\n\tgh_repo: async () => (await import(\"./gh.js\")).ghRepoTool,\n\tpipeline_search_contacts: async () =>\n\t\t(await import(\"./pipeline.js\")).pipelineSearchContactsTool,\n\tpipeline_search_deals: async () =>\n\t\t(await import(\"./pipeline.js\")).pipelineSearchDealsTool,\n\tpipeline_create_signal: async () =>\n\t\t(await import(\"./pipeline.js\")).pipelineCreateSignalTool,\n\tpipeline_log_activity: async () =>\n\t\t(await import(\"./pipeline.js\")).pipelineLogActivityTool,\n} satisfies Record<string, () => Promise<AgentTool>>;\n\nexport const lazyToolNames = Object.keys(lazyToolLoaders).sort();\n\nexport async function loadFilteredTools(\n\ttoolNames: string[],\n): Promise<AgentTool[]> {\n\tconst filtered: AgentTool[] = [];\n\tfor (const name of toolNames) {\n\t\tconst loadTool = lazyToolLoaders[name as keyof typeof lazyToolLoaders];\n\t\tif (loadTool) {\n\t\t\tfiltered.push(await loadTool());\n\t\t}\n\t}\n\treturn filtered;\n}\n"]}

package/dist/tools/oracle.d.ts

@@ -4,6 +4,15 @@ export interface OracleToolDetails {
     context?: string;
     files?: string[];
 }
+export interface OracleModelCandidate {
+    id: string;
+    provider?: string;
+    reasoning?: boolean;
+}
+export declare function selectComplementaryOracleModel<T extends OracleModelCandidate>(models: T[], options?: {
+    primaryProvider?: string;
+    preferredId?: string;
+}): T;
 export declare const oracleTool: Readonly<{
     name: string;
     label: string;

package/dist/tools/oracle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"oracle.d.ts","sourceRoot":"","sources":["../../src/tools/oracle.ts"],"names":[],"mappings":"AA2CA,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;EAyJrB,CAAC"}
+{"version":3,"file":"oracle.d.ts","sourceRoot":"","sources":["../../src/tools/oracle.ts"],"names":[],"mappings":"AA4CA,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,8BAA8B,CAAC,CAAC,SAAS,oBAAoB,EAC5E,MAAM,EAAE,CAAC,EAAE,EACX,OAAO,GAAE;IAAE,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GAC9D,CAAC,CA2BH;AAED,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;EAyJrB,CAAC"}

package/dist/tools/oracle.js

@@ -7,6 +7,7 @@ import { formatDelegation } from "@evalops/contracts";
 import { Type } from "@sinclair/typebox";
 import { getRegisteredModels } from "../models/registry.js";
 import { buildEvalOpsDelegationEnvironment, issueEvalOpsDelegationToken, } from "../oauth/index.js";
+import { defaultRuntimeEnv } from "../runtime/env.js";
 import { createTool } from "./tool-dsl.js";
 import { readOnlyToolNames } from "./tool-names.js";
 const ORACLE_TIMEOUT_MS = 120_000;
@@ -24,6 +25,27 @@ const oracleSchema = Type.Object({
         description: "Optional list of specific file paths that the Oracle should examine as part of its analysis.",
     })),
 });
+export function selectComplementaryOracleModel(models, options = {}) {
+    const preferred = options.preferredId?.trim();
+    if (preferred) {
+        const preferredRefs = new Set([
+            preferred,
+            preferred.startsWith("openai/") ? preferred : `openai/${preferred}`,
+        ]);
+        const explicit = models.find((model) => model.reasoning === true && preferredRefs.has(model.id));
+        if (explicit)
+            return explicit;
+    }
+    const complementary = models.find((model) => model.reasoning === true &&
+        Boolean(model.provider) &&
+        model.provider !== options.primaryProvider);
+    if (complementary)
+        return complementary;
+    const reasoning = models.find((model) => model.reasoning === true);
+    if (reasoning)
+        return reasoning;
+    throw new Error("No reasoning-capable model is configured for Oracle. Configure an explicit Oracle model or add a reasoning model.");
+}
 export const oracleTool = createTool({
     name: "oracle",
     description: "Summon the Seer - a mystical systems advisor that foresees consequences of complex engineering decisions. Ideal for architecture reviews, deep debugging, and strategic guidance.",
@@ -184,29 +206,9 @@ function selectOracleModel(inputOverride) {
     const envOverride = process.env.MAESTRO_ORACLE_MODEL?.trim();
     const preferred = inputOverride?.trim() ||
         (envOverride && envOverride.length > 0 ? envOverride : "o3-mini");
-    const models = getRegisteredModels();
-    // Try the preferred id and common provider-qualified variant
-    const candidates = [
-        preferred,
-        preferred.startsWith("openai/") ? preferred : `openai/${preferred}`,
-    ];
-    const found = models.find((m) => candidates.includes(m.id));
-    if (found) {
-        return found.id;
-    }
-    // Fall back to any reasoning-capable model
-    const reasoning = models.find((m) => m.reasoning === true);
-    if (reasoning) {
-        return reasoning.id;
-    }
-    // As a last resort, fall back to any configured model so the tool can still run.
-    // This prevents hard runtime failures while surfacing a clear warning.
-    const fallback = models.at(0);
-    if (fallback) {
-        return fallback.id;
-    }
-    // No acceptable model configured
-    const available = models.map((m) => m.id).join(", ");
-    throw new Error(`No model configured for Oracle. Tried ${preferred}. Set MAESTRO_ORACLE_MODEL to an available model or add a reasoning-capable model. Available models: ${available || "none"}.`);
+    return selectComplementaryOracleModel(getRegisteredModels(), {
+        preferredId: preferred,
+        primaryProvider: defaultRuntimeEnv().primaryModelProvider ?? undefined,
+    }).id;
 }
 //# sourceMappingURL=oracle.js.map

package/dist/tools/oracle.js.map

@@ -1 +1 @@
-{"version":3,"file":"oracle.js","sourceRoot":"","sources":["../../src/tools/oracle.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn } from \"node:child_process\";\nimport { randomUUID } from \"node:crypto\";\nimport { unlinkSync, writeFileSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { type DelegationPrompt, formatDelegation } from \"@evalops/contracts\";\nimport { Type } from \"@sinclair/typebox\";\nimport type { Static } from \"@sinclair/typebox\";\nimport { getRegisteredModels } from \"../models/registry.js\";\nimport {\n\tbuildEvalOpsDelegationEnvironment,\n\tissueEvalOpsDelegationToken,\n} from \"../oauth/index.js\";\nimport { createTool } from \"./tool-dsl.js\";\nimport { readOnlyToolNames } from \"./tool-names.js\";\n\nconst ORACLE_TIMEOUT_MS = 120_000;\n\nconst oracleSchema = Type.Object({\n\ttask: Type.String({\n\t\tdescription:\n\t\t\t\"The task or question you want the Oracle to help with. Be specific about what kind of guidance, review, or planning you need.\",\n\t}),\n\tmodel: Type.Optional(\n\t\tType.String({\n\t\t\tdescription:\n\t\t\t\t\"Optional model id to use for the Oracle (must be available in your configured models). Defaults to a reasoning-capable model such as o3-mini.\",\n\t\t}),\n\t),\n\tcontext: Type.Optional(\n\t\tType.String({\n\t\t\tdescription:\n\t\t\t\t\"Optional context about the current situation, what you've tried, or background information that would help the Oracle provide better guidance.\",\n\t\t}),\n\t),\n\tfiles: Type.Optional(\n\t\tType.Array(Type.String(), {\n\t\t\tdescription:\n\t\t\t\t\"Optional list of specific file paths that the Oracle should examine as part of its analysis.\",\n\t\t}),\n\t),\n});\n\nexport interface OracleToolDetails {\n\ttask: string;\n\tmodel?: string;\n\tcontext?: string;\n\tfiles?: string[];\n}\n\nexport const oracleTool = createTool<typeof oracleSchema, OracleToolDetails>({\n\tname: \"oracle\",\n\tdescription:\n\t\t\"Summon the Seer - a mystical systems advisor that foresees consequences of complex engineering decisions. Ideal for architecture reviews, deep debugging, and strategic guidance.\",\n\tschema: oracleSchema,\n\tasync run(params, { respond, signal, toolCallId }) {\n\t\tconst { task, context, files, model: modelOverride } = params;\n\t\tconst model = selectOracleModel(modelOverride);\n\n\t\t// Create temporary input file with the Seer summoning\n\t\tconst tmpFile = join(tmpdir(), `seer-${randomUUID()}.md`);\n\n\t\tconst delegationPrompt: DelegationPrompt = {\n\t\t\tgoal: \"Provide read-only architectural guidance for a complex engineering decision.\",\n\t\t\tcontext:\n\t\t\t\tcontext ??\n\t\t\t\t\"The caller did not provide extra context beyond the task and artifacts.\",\n\t\t\ttask,\n\t\t\tevidence: files?.length\n\t\t\t\t? files.map((file) => `Artifact to examine: ${file}`)\n\t\t\t\t: [],\n\t\t\tvalidation:\n\t\t\t\t\"Inspect referenced artifacts before drawing conclusions, cite file paths and line numbers when possible, and separate evidence from assumptions.\",\n\t\t\tstoppingCondition:\n\t\t\t\t\"Stop after a concise response with Summary, Insights, optional Next steps, any uncertainties, then final lines `Effort: <S|M|L|XL> (<rough duration or reason>)` and optional `Revisit-if: <signal>`. Never edit or run code.\",\n\t\t};\n\t\tconst prompt = [\n\t\t\t\"You are the Seer, a read-only software architecture advisor. You must never edit or run code.\",\n\t\t\t\"\",\n\t\t\tformatDelegation(delegationPrompt),\n\t\t].join(\"\\n\");\n\n\t\twriteFileSync(tmpFile, prompt);\n\n\t\tlet fileCleanedUp = false;\n\t\tconst cleanupFile = () => {\n\t\t\tif (fileCleanedUp) return;\n\t\t\tfileCleanedUp = true;\n\t\t\ttry {\n\t\t\t\tunlinkSync(tmpFile);\n\t\t\t} catch {\n\t\t\t\t// File already deleted or other error - ignore\n\t\t\t}\n\t\t};\n\n\t\ttry {\n\t\t\tconst env = await buildOracleEnv(toolCallId);\n\n\t\t\t// Spawn Seer subagent with read-only tools and reasoning model\n\t\t\tconst args = [\n\t\t\t\t\"--read-only\",\n\t\t\t\t\"--tools\",\n\t\t\t\treadOnlyToolNames.join(\",\"),\n\t\t\t\t\"--model\",\n\t\t\t\tmodel, // Use validated reasoning model for prophetic insights\n\t\t\t\t\"--no-session\",\n\t\t\t\t\"exec\",\n\t\t\t\ttmpFile,\n\t\t\t];\n\n\t\t\tconst result = await new Promise<string>((resolve, reject) => {\n\t\t\t\tif (signal?.aborted) {\n\t\t\t\t\tcleanupFile();\n\t\t\t\t\treject(new Error(\"Seer invocation aborted\"));\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tconst seer = spawn(\"maestro\", args, {\n\t\t\t\t\tenv,\n\t\t\t\t\tstdio: [\"pipe\", \"pipe\", \"pipe\"],\n\t\t\t\t});\n\n\t\t\t\tlet output = \"\";\n\t\t\t\tlet errorOutput = \"\";\n\t\t\t\tlet timedOut = false;\n\t\t\t\tlet aborted = false;\n\t\t\t\tlet timeoutHandle: NodeJS.Timeout | null = null;\n\n\t\t\t\tconst killChild = () => {\n\t\t\t\t\tif (seer.pid) {\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tprocess.kill(seer.pid);\n\t\t\t\t\t\t} catch {\n\t\t\t\t\t\t\t// Already terminated\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t};\n\n\t\t\t\tconst cleanupListeners = () => {\n\t\t\t\t\tif (timeoutHandle) {\n\t\t\t\t\t\tclearTimeout(timeoutHandle);\n\t\t\t\t\t}\n\t\t\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t\t\t\t};\n\n\t\t\t\tconst onAbort = () => {\n\t\t\t\t\taborted = true;\n\t\t\t\t\tkillChild();\n\t\t\t\t};\n\n\t\t\t\tif (signal) {\n\t\t\t\t\tsignal.addEventListener(\"abort\", onAbort);\n\t\t\t\t}\n\n\t\t\t\tconst startTimeout = () => {\n\t\t\t\t\ttimeoutHandle = setTimeout(() => {\n\t\t\t\t\t\ttimedOut = true;\n\t\t\t\t\t\tkillChild();\n\t\t\t\t\t}, ORACLE_TIMEOUT_MS);\n\t\t\t\t};\n\n\t\t\t\tstartTimeout();\n\n\t\t\t\tseer.stdout.on(\"data\", (data) => {\n\t\t\t\t\toutput += data.toString();\n\t\t\t\t});\n\n\t\t\t\tseer.stderr.on(\"data\", (data) => {\n\t\t\t\t\terrorOutput += data.toString();\n\t\t\t\t});\n\n\t\t\t\tseer.on(\"close\", (code) => {\n\t\t\t\t\tcleanupFile();\n\t\t\t\t\tcleanupListeners();\n\n\t\t\t\t\tif (code === 0 && !timedOut && !aborted) {\n\t\t\t\t\t\tresolve(output.trim());\n\t\t\t\t\t} else {\n\t\t\t\t\t\treject(\n\t\t\t\t\t\t\tnew Error(\n\t\t\t\t\t\t\t\taborted\n\t\t\t\t\t\t\t\t\t? \"Seer invocation aborted\"\n\t\t\t\t\t\t\t\t\t: timedOut\n\t\t\t\t\t\t\t\t\t\t? \"Seer divination timed out\"\n\t\t\t\t\t\t\t\t\t\t: `Seer divination failed (exit ${code}): ${errorOutput}`,\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t});\n\n\t\t\t\tseer.on(\"error\", (err) => {\n\t\t\t\t\tcleanupFile();\n\t\t\t\t\tcleanupListeners();\n\t\t\t\t\treject(new Error(`Failed to summon the Seer: ${err.message}`));\n\t\t\t\t});\n\t\t\t});\n\n\t\t\treturn respond.text(result);\n\t\t} catch (error) {\n\t\t\tcleanupFile();\n\t\t\tthrow error;\n\t\t}\n\t},\n});\n\nasync function buildOracleEnv(\n\ttoolCallId: string,\n): Promise<Record<string, string | undefined>> {\n\tconst baseEnv = { ...process.env };\n\n\ttry {\n\t\tconst delegation = await issueEvalOpsDelegationToken({\n\t\t\tagentId: toolCallId,\n\t\t\tagentType: \"oracle_seer\",\n\t\t\tcapabilities: [\"oracle_read_only\"],\n\t\t\trunId: toolCallId,\n\t\t\tsurface: \"maestro-oracle\",\n\t\t\ttoken: process.env.MAESTRO_EVALOPS_ACCESS_TOKEN,\n\t\t\tttlSeconds: Math.max(60, Math.ceil(ORACLE_TIMEOUT_MS / 1000)),\n\t\t});\n\n\t\treturn {\n\t\t\t...baseEnv,\n\t\t\t...buildEvalOpsDelegationEnvironment(delegation),\n\t\t};\n\t} catch (error) {\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\tif (\n\t\t\tmessage.includes(\"Run /login evalops first\") ||\n\t\t\tmessage.includes(\"EvalOps login requires\")\n\t\t) {\n\t\t\treturn baseEnv;\n\t\t}\n\n\t\treturn baseEnv;\n\t}\n}\n\nfunction selectOracleModel(inputOverride?: string): string {\n\tconst envOverride = process.env.MAESTRO_ORACLE_MODEL?.trim();\n\tconst preferred =\n\t\tinputOverride?.trim() ||\n\t\t(envOverride && envOverride.length > 0 ? envOverride : \"o3-mini\");\n\tconst models = getRegisteredModels();\n\n\t// Try the preferred id and common provider-qualified variant\n\tconst candidates = [\n\t\tpreferred,\n\t\tpreferred.startsWith(\"openai/\") ? preferred : `openai/${preferred}`,\n\t];\n\tconst found = models.find((m) => candidates.includes(m.id));\n\tif (found) {\n\t\treturn found.id;\n\t}\n\n\t// Fall back to any reasoning-capable model\n\tconst reasoning = models.find((m) => m.reasoning === true);\n\tif (reasoning) {\n\t\treturn reasoning.id;\n\t}\n\n\t// As a last resort, fall back to any configured model so the tool can still run.\n\t// This prevents hard runtime failures while surfacing a clear warning.\n\tconst fallback = models.at(0);\n\tif (fallback) {\n\t\treturn fallback.id;\n\t}\n\n\t// No acceptable model configured\n\tconst available = models.map((m) => m.id).join(\", \");\n\tthrow new Error(\n\t\t`No model configured for Oracle. Tried ${preferred}. Set MAESTRO_ORACLE_MODEL to an available model or add a reasoning-capable model. Available models: ${available || \"none\"}.`,\n\t);\n}\n"]}
+{"version":3,"file":"oracle.js","sourceRoot":"","sources":["../../src/tools/oracle.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn } from \"node:child_process\";\nimport { randomUUID } from \"node:crypto\";\nimport { unlinkSync, writeFileSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { type DelegationPrompt, formatDelegation } from \"@evalops/contracts\";\nimport { Type } from \"@sinclair/typebox\";\nimport type { Static } from \"@sinclair/typebox\";\nimport { getRegisteredModels } from \"../models/registry.js\";\nimport {\n\tbuildEvalOpsDelegationEnvironment,\n\tissueEvalOpsDelegationToken,\n} from \"../oauth/index.js\";\nimport { defaultRuntimeEnv } from \"../runtime/env.js\";\nimport { createTool } from \"./tool-dsl.js\";\nimport { readOnlyToolNames } from \"./tool-names.js\";\n\nconst ORACLE_TIMEOUT_MS = 120_000;\n\nconst oracleSchema = Type.Object({\n\ttask: Type.String({\n\t\tdescription:\n\t\t\t\"The task or question you want the Oracle to help with. Be specific about what kind of guidance, review, or planning you need.\",\n\t}),\n\tmodel: Type.Optional(\n\t\tType.String({\n\t\t\tdescription:\n\t\t\t\t\"Optional model id to use for the Oracle (must be available in your configured models). Defaults to a reasoning-capable model such as o3-mini.\",\n\t\t}),\n\t),\n\tcontext: Type.Optional(\n\t\tType.String({\n\t\t\tdescription:\n\t\t\t\t\"Optional context about the current situation, what you've tried, or background information that would help the Oracle provide better guidance.\",\n\t\t}),\n\t),\n\tfiles: Type.Optional(\n\t\tType.Array(Type.String(), {\n\t\t\tdescription:\n\t\t\t\t\"Optional list of specific file paths that the Oracle should examine as part of its analysis.\",\n\t\t}),\n\t),\n});\n\nexport interface OracleToolDetails {\n\ttask: string;\n\tmodel?: string;\n\tcontext?: string;\n\tfiles?: string[];\n}\n\nexport interface OracleModelCandidate {\n\tid: string;\n\tprovider?: string;\n\treasoning?: boolean;\n}\n\nexport function selectComplementaryOracleModel<T extends OracleModelCandidate>(\n\tmodels: T[],\n\toptions: { primaryProvider?: string; preferredId?: string } = {},\n): T {\n\tconst preferred = options.preferredId?.trim();\n\tif (preferred) {\n\t\tconst preferredRefs = new Set([\n\t\t\tpreferred,\n\t\t\tpreferred.startsWith(\"openai/\") ? preferred : `openai/${preferred}`,\n\t\t]);\n\t\tconst explicit = models.find(\n\t\t\t(model) => model.reasoning === true && preferredRefs.has(model.id),\n\t\t);\n\t\tif (explicit) return explicit;\n\t}\n\n\tconst complementary = models.find(\n\t\t(model) =>\n\t\t\tmodel.reasoning === true &&\n\t\t\tBoolean(model.provider) &&\n\t\t\tmodel.provider !== options.primaryProvider,\n\t);\n\tif (complementary) return complementary;\n\n\tconst reasoning = models.find((model) => model.reasoning === true);\n\tif (reasoning) return reasoning;\n\n\tthrow new Error(\n\t\t\"No reasoning-capable model is configured for Oracle. Configure an explicit Oracle model or add a reasoning model.\",\n\t);\n}\n\nexport const oracleTool = createTool<typeof oracleSchema, OracleToolDetails>({\n\tname: \"oracle\",\n\tdescription:\n\t\t\"Summon the Seer - a mystical systems advisor that foresees consequences of complex engineering decisions. Ideal for architecture reviews, deep debugging, and strategic guidance.\",\n\tschema: oracleSchema,\n\tasync run(params, { respond, signal, toolCallId }) {\n\t\tconst { task, context, files, model: modelOverride } = params;\n\t\tconst model = selectOracleModel(modelOverride);\n\n\t\t// Create temporary input file with the Seer summoning\n\t\tconst tmpFile = join(tmpdir(), `seer-${randomUUID()}.md`);\n\n\t\tconst delegationPrompt: DelegationPrompt = {\n\t\t\tgoal: \"Provide read-only architectural guidance for a complex engineering decision.\",\n\t\t\tcontext:\n\t\t\t\tcontext ??\n\t\t\t\t\"The caller did not provide extra context beyond the task and artifacts.\",\n\t\t\ttask,\n\t\t\tevidence: files?.length\n\t\t\t\t? files.map((file) => `Artifact to examine: ${file}`)\n\t\t\t\t: [],\n\t\t\tvalidation:\n\t\t\t\t\"Inspect referenced artifacts before drawing conclusions, cite file paths and line numbers when possible, and separate evidence from assumptions.\",\n\t\t\tstoppingCondition:\n\t\t\t\t\"Stop after a concise response with Summary, Insights, optional Next steps, any uncertainties, then final lines `Effort: <S|M|L|XL> (<rough duration or reason>)` and optional `Revisit-if: <signal>`. Never edit or run code.\",\n\t\t};\n\t\tconst prompt = [\n\t\t\t\"You are the Seer, a read-only software architecture advisor. You must never edit or run code.\",\n\t\t\t\"\",\n\t\t\tformatDelegation(delegationPrompt),\n\t\t].join(\"\\n\");\n\n\t\twriteFileSync(tmpFile, prompt);\n\n\t\tlet fileCleanedUp = false;\n\t\tconst cleanupFile = () => {\n\t\t\tif (fileCleanedUp) return;\n\t\t\tfileCleanedUp = true;\n\t\t\ttry {\n\t\t\t\tunlinkSync(tmpFile);\n\t\t\t} catch {\n\t\t\t\t// File already deleted or other error - ignore\n\t\t\t}\n\t\t};\n\n\t\ttry {\n\t\t\tconst env = await buildOracleEnv(toolCallId);\n\n\t\t\t// Spawn Seer subagent with read-only tools and reasoning model\n\t\t\tconst args = [\n\t\t\t\t\"--read-only\",\n\t\t\t\t\"--tools\",\n\t\t\t\treadOnlyToolNames.join(\",\"),\n\t\t\t\t\"--model\",\n\t\t\t\tmodel, // Use validated reasoning model for prophetic insights\n\t\t\t\t\"--no-session\",\n\t\t\t\t\"exec\",\n\t\t\t\ttmpFile,\n\t\t\t];\n\n\t\t\tconst result = await new Promise<string>((resolve, reject) => {\n\t\t\t\tif (signal?.aborted) {\n\t\t\t\t\tcleanupFile();\n\t\t\t\t\treject(new Error(\"Seer invocation aborted\"));\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tconst seer = spawn(\"maestro\", args, {\n\t\t\t\t\tenv,\n\t\t\t\t\tstdio: [\"pipe\", \"pipe\", \"pipe\"],\n\t\t\t\t});\n\n\t\t\t\tlet output = \"\";\n\t\t\t\tlet errorOutput = \"\";\n\t\t\t\tlet timedOut = false;\n\t\t\t\tlet aborted = false;\n\t\t\t\tlet timeoutHandle: NodeJS.Timeout | null = null;\n\n\t\t\t\tconst killChild = () => {\n\t\t\t\t\tif (seer.pid) {\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tprocess.kill(seer.pid);\n\t\t\t\t\t\t} catch {\n\t\t\t\t\t\t\t// Already terminated\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t};\n\n\t\t\t\tconst cleanupListeners = () => {\n\t\t\t\t\tif (timeoutHandle) {\n\t\t\t\t\t\tclearTimeout(timeoutHandle);\n\t\t\t\t\t}\n\t\t\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t\t\t\t};\n\n\t\t\t\tconst onAbort = () => {\n\t\t\t\t\taborted = true;\n\t\t\t\t\tkillChild();\n\t\t\t\t};\n\n\t\t\t\tif (signal) {\n\t\t\t\t\tsignal.addEventListener(\"abort\", onAbort);\n\t\t\t\t}\n\n\t\t\t\tconst startTimeout = () => {\n\t\t\t\t\ttimeoutHandle = setTimeout(() => {\n\t\t\t\t\t\ttimedOut = true;\n\t\t\t\t\t\tkillChild();\n\t\t\t\t\t}, ORACLE_TIMEOUT_MS);\n\t\t\t\t};\n\n\t\t\t\tstartTimeout();\n\n\t\t\t\tseer.stdout.on(\"data\", (data) => {\n\t\t\t\t\toutput += data.toString();\n\t\t\t\t});\n\n\t\t\t\tseer.stderr.on(\"data\", (data) => {\n\t\t\t\t\terrorOutput += data.toString();\n\t\t\t\t});\n\n\t\t\t\tseer.on(\"close\", (code) => {\n\t\t\t\t\tcleanupFile();\n\t\t\t\t\tcleanupListeners();\n\n\t\t\t\t\tif (code === 0 && !timedOut && !aborted) {\n\t\t\t\t\t\tresolve(output.trim());\n\t\t\t\t\t} else {\n\t\t\t\t\t\treject(\n\t\t\t\t\t\t\tnew Error(\n\t\t\t\t\t\t\t\taborted\n\t\t\t\t\t\t\t\t\t? \"Seer invocation aborted\"\n\t\t\t\t\t\t\t\t\t: timedOut\n\t\t\t\t\t\t\t\t\t\t? \"Seer divination timed out\"\n\t\t\t\t\t\t\t\t\t\t: `Seer divination failed (exit ${code}): ${errorOutput}`,\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t});\n\n\t\t\t\tseer.on(\"error\", (err) => {\n\t\t\t\t\tcleanupFile();\n\t\t\t\t\tcleanupListeners();\n\t\t\t\t\treject(new Error(`Failed to summon the Seer: ${err.message}`));\n\t\t\t\t});\n\t\t\t});\n\n\t\t\treturn respond.text(result);\n\t\t} catch (error) {\n\t\t\tcleanupFile();\n\t\t\tthrow error;\n\t\t}\n\t},\n});\n\nasync function buildOracleEnv(\n\ttoolCallId: string,\n): Promise<Record<string, string | undefined>> {\n\tconst baseEnv = { ...process.env };\n\n\ttry {\n\t\tconst delegation = await issueEvalOpsDelegationToken({\n\t\t\tagentId: toolCallId,\n\t\t\tagentType: \"oracle_seer\",\n\t\t\tcapabilities: [\"oracle_read_only\"],\n\t\t\trunId: toolCallId,\n\t\t\tsurface: \"maestro-oracle\",\n\t\t\ttoken: process.env.MAESTRO_EVALOPS_ACCESS_TOKEN,\n\t\t\tttlSeconds: Math.max(60, Math.ceil(ORACLE_TIMEOUT_MS / 1000)),\n\t\t});\n\n\t\treturn {\n\t\t\t...baseEnv,\n\t\t\t...buildEvalOpsDelegationEnvironment(delegation),\n\t\t};\n\t} catch (error) {\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\tif (\n\t\t\tmessage.includes(\"Run /login evalops first\") ||\n\t\t\tmessage.includes(\"EvalOps login requires\")\n\t\t) {\n\t\t\treturn baseEnv;\n\t\t}\n\n\t\treturn baseEnv;\n\t}\n}\n\nfunction selectOracleModel(inputOverride?: string): string {\n\tconst envOverride = process.env.MAESTRO_ORACLE_MODEL?.trim();\n\tconst preferred =\n\t\tinputOverride?.trim() ||\n\t\t(envOverride && envOverride.length > 0 ? envOverride : \"o3-mini\");\n\treturn selectComplementaryOracleModel(getRegisteredModels(), {\n\t\tpreferredId: preferred,\n\t\tprimaryProvider: defaultRuntimeEnv().primaryModelProvider ?? undefined,\n\t}).id;\n}\n"]}

package/dist/tools/painter.d.ts

@@ -0,0 +1,73 @@
+import { type ImageDimensions, type MaskRegion } from "../services/image-providers/masks.js";
+export declare function painterTimeoutMs(): number;
+export declare function painterOutputDir(): string;
+export declare function resolvePainterModel(): string;
+/** Resolve the image provider. "openai" (default) or "flux" via fal.ai. */
+export declare function resolvePainterProvider(): "openai" | "flux";
+export declare function persistImage(bytes: Buffer, ext: string): Promise<{
+    path: string;
+}>;
+/**
+ * Classify whether an image-API failure is worth one retry. Image generation
+ * is expensive, so we retry only on clearly transient network/rate-limit
+ * faults and never on validation or content-policy rejections.
+ */
+export declare function isTransientImageError(err: unknown): boolean;
+export type MaskDimensionSource = "png-header" | "sharp" | "explicit";
+/**
+ * Resolve a pixel bounding box into a mask file path, writing the synthesized
+ * mask into the painter output directory. Dimensions come from (in order):
+ * the PNG header (no deps), the optional `sharp` package, or an explicit
+ * caller-supplied size. Returns the temp mask path plus how dims were found.
+ */
+export declare function buildMaskPath(images: string[], region: MaskRegion, explicitSize?: ImageDimensions): Promise<{
+    maskPath: string;
+    dimensions: ImageDimensions;
+    source: MaskDimensionSource;
+}>;
+export interface PainterToolDetails {
+    provider: string;
+    model: string;
+    mode: "generate" | "edit";
+    paths: string[];
+}
+export declare const painterTool: Readonly<{
+    name: string;
+    label: string;
+    description: string;
+    parameters: import("@sinclair/typebox").TObject<{
+        mode: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"generate">, import("@sinclair/typebox").TLiteral<"edit">]>;
+        prompt: import("@sinclair/typebox").TString;
+        images: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+        mask: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        maskRegion: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+            x: import("@sinclair/typebox").TNumber;
+            y: import("@sinclair/typebox").TNumber;
+            width: import("@sinclair/typebox").TNumber;
+            height: import("@sinclair/typebox").TNumber;
+        }>>;
+        maskSize: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+            width: import("@sinclair/typebox").TInteger;
+            height: import("@sinclair/typebox").TInteger;
+        }>>;
+        size: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        quality: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"low">, import("@sinclair/typebox").TLiteral<"medium">, import("@sinclair/typebox").TLiteral<"high">, import("@sinclair/typebox").TLiteral<"auto">]>>;
+        n: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+    }>;
+    annotations: import("../agent/types.js").ToolAnnotations | undefined;
+    source: import("../agent/types.js").McpToolSourceMetadata | undefined;
+    toolType: string | undefined;
+    inputExamples: unknown[] | undefined;
+    allowedCallers: string[] | undefined;
+    deferApiDefinition: boolean | undefined;
+    maxRetries: number | undefined;
+    retryDelayMs: number | undefined;
+    shouldRetry: ((error: unknown) => boolean) | undefined;
+    getToolUseSummary: ((params: Record<string, unknown>) => string | null) | undefined;
+    getDisplayName: ((params: Record<string, unknown>) => string | null) | undefined;
+    getActivityDescription: ((params: Record<string, unknown>) => string | null) | undefined;
+    execute: (toolCallId: string, params: Record<string, unknown>, signal?: AbortSignal, context?: {
+        sandbox?: import("../sandbox/types.js").Sandbox;
+    } | undefined, onUpdate?: import("../agent/types.js").AgentToolUpdateCallback<PainterToolDetails> | undefined) => Promise<import("../agent/types.js").AgentToolResult<PainterToolDetails>>;
+}>;
+//# sourceMappingURL=painter.d.ts.map

package/dist/tools/painter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"painter.d.ts","sourceRoot":"","sources":["../../src/tools/painter.ts"],"names":[],"mappings":"AAOA,OAAO,EACN,KAAK,eAAe,EACpB,KAAK,UAAU,EAGf,MAAM,sCAAsC,CAAC;AAe9C,wBAAgB,gBAAgB,IAAI,MAAM,CAOzC;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAIzC;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,2EAA2E;AAC3E,wBAAgB,sBAAsB,IAAI,QAAQ,GAAG,MAAM,CAG1D;AAED,wBAAsB,YAAY,CACjC,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GACT,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAM3B;AAcD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAY3D;AAED,MAAM,MAAM,mBAAmB,GAAG,YAAY,GAAG,OAAO,GAAG,UAAU,CAAC;AAEtE;;;;;GAKG;AACH,wBAAsB,aAAa,CAClC,MAAM,EAAE,MAAM,EAAE,EAChB,MAAM,EAAE,UAAU,EAClB,YAAY,CAAC,EAAE,eAAe,GAC5B,OAAO,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,eAAe,CAAC;IAC5B,MAAM,EAAE,mBAAmB,CAAC;CAC5B,CAAC,CA0CD;AA8ED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC;IAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4JvB,CAAC"}

package/dist/tools/painter.js

@@ -0,0 +1,283 @@
+import { randomBytes } from "node:crypto";
+import { readFile, unlink } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+import { Type } from "@sinclair/typebox";
+import { getPainterBudget } from "../services/image-providers/cost.js";
+import { createImageProvider } from "../services/image-providers/index.js";
+import { encodeMaskPng, readPngDimensions, } from "../services/image-providers/masks.js";
+import { writeTextFileAtomic } from "../utils/fs.js";
+import { createLogger } from "../utils/logger.js";
+import { getImageMetadata } from "./image-processor.js";
+import { createTool } from "./tool-dsl.js";
+const logger = createLogger("tools:painter");
+const DEFAULT_PAINTER_TIMEOUT_MS = 180_000;
+const DEFAULT_MODEL = "gpt-image-2";
+export function painterTimeoutMs() {
+    const raw = process.env.MAESTRO_PAINTER_TIMEOUT_MS;
+    if (!raw)
+        return DEFAULT_PAINTER_TIMEOUT_MS;
+    const parsed = Number.parseInt(raw, 10);
+    return Number.isFinite(parsed) && parsed > 0
+        ? parsed
+        : DEFAULT_PAINTER_TIMEOUT_MS;
+}
+export function painterOutputDir() {
+    const override = process.env.MAESTRO_PAINTER_OUTPUT_DIR?.trim();
+    if (override)
+        return resolve(override);
+    return join(homedir(), ".maestro", "assets", "painter");
+}
+export function resolvePainterModel() {
+    return process.env.MAESTRO_PAINTER_MODEL?.trim() || DEFAULT_MODEL;
+}
+/** Resolve the image provider. "openai" (default) or "flux" via fal.ai. */
+export function resolvePainterProvider() {
+    const raw = process.env.MAESTRO_PAINTER_PROVIDER?.trim().toLowerCase();
+    return raw === "flux" ? "flux" : "openai";
+}
+export async function persistImage(bytes, ext) {
+    const dir = painterOutputDir();
+    const name = `painter-${Date.now()}-${randomBytes(4).toString("hex")}.${ext}`;
+    const path = join(dir, name);
+    writeTextFileAtomic(path, bytes.toString("latin1"), { encoding: "latin1" });
+    return { path };
+}
+/** Errno-style codes that indicate a transient network fault worth retrying. */
+const TRANSIENT_ERRNO_CODES = new Set([
+    "ETIMEDOUT",
+    "ECONNRESET",
+    "ENOTFOUND",
+    "ECONNREFUSED",
+    "EAI_AGAIN",
+    "EPIPE",
+    "EHOSTUNREACH",
+    "ENETUNREACH",
+]);
+/**
+ * Classify whether an image-API failure is worth one retry. Image generation
+ * is expensive, so we retry only on clearly transient network/rate-limit
+ * faults and never on validation or content-policy rejections.
+ */
+export function isTransientImageError(err) {
+    const code = err?.code;
+    if (typeof code === "string" &&
+        TRANSIENT_ERRNO_CODES.has(code.toUpperCase())) {
+        return true;
+    }
+    const msg = err instanceof Error ? err.message : String(err);
+    return /rate limit|too many requests|timeout|timed out|econnreset|enotfound|etimedout|econnrefused|service unavailable|bad gateway|5\d{2}/i.test(msg);
+}
+/**
+ * Resolve a pixel bounding box into a mask file path, writing the synthesized
+ * mask into the painter output directory. Dimensions come from (in order):
+ * the PNG header (no deps), the optional `sharp` package, or an explicit
+ * caller-supplied size. Returns the temp mask path plus how dims were found.
+ */
+export async function buildMaskPath(images, region, explicitSize) {
+    if (images.length === 0) {
+        throw new Error("mask synthesis requires at least one input image path.");
+    }
+    const inputPath = images[0];
+    if (!inputPath) {
+        throw new Error("mask synthesis received an undefined input image path.");
+    }
+    const buf = await readFile(inputPath);
+    let dimensions = readPngDimensions(buf);
+    let source = "png-header";
+    if (!dimensions) {
+        if (explicitSize) {
+            dimensions = explicitSize;
+            source = "explicit";
+        }
+        else {
+            const meta = await getImageMetadata(buf);
+            if (meta?.width && meta.height) {
+                dimensions = { width: meta.width, height: meta.height };
+                source = "sharp";
+            }
+        }
+    }
+    if (!dimensions) {
+        throw new Error("Could not determine input image dimensions for mask synthesis. Use a PNG input, enable Sharp, or pass maskSize explicitly.");
+    }
+    const maskBuf = encodeMaskPng(dimensions, region);
+    const dir = painterOutputDir();
+    const maskPath = join(dir, `mask-${Date.now()}-${randomBytes(4).toString("hex")}.png`);
+    writeTextFileAtomic(maskPath, maskBuf.toString("latin1"), {
+        encoding: "latin1",
+    });
+    return { maskPath, dimensions, source };
+}
+const painterSchema = Type.Object({
+    mode: Type.Union([Type.Literal("generate"), Type.Literal("edit")], {
+        description: "generate = create a new image from a text prompt. edit = modify one or more existing images using a prompt (and optional mask).",
+    }),
+    prompt: Type.String({
+        description: "The image prompt. For edit mode, describe the desired change. Be concrete about subject, style, composition, and any text to render.",
+    }),
+    images: Type.Optional(Type.Array(Type.String(), {
+        description: "Edit mode only. 1-3 absolute or workspace-relative paths to input images to edit.",
+    })),
+    mask: Type.Optional(Type.String({
+        description: "Edit mode only. Path to a mask image; transparent regions mark areas the model may change. Omit to edit the whole image. Mutually exclusive with maskRegion (which synthesizes the mask for you).",
+    })),
+    maskRegion: Type.Optional(Type.Object({
+        x: Type.Number({ description: "Region left edge, in pixels." }),
+        y: Type.Number({ description: "Region top edge, in pixels." }),
+        width: Type.Number({ description: "Region width, in pixels." }),
+        height: Type.Number({ description: "Region height, in pixels." }),
+    }, {
+        description: "Edit mode only. A pixel bounding box; the mask is synthesized automatically (transparent = editable). Coordinates outside the image are clipped.",
+    })),
+    maskSize: Type.Optional(Type.Object({
+        width: Type.Integer({ minimum: 1 }),
+        height: Type.Integer({ minimum: 1 }),
+    }, {
+        description: "Explicit input image dimensions, used only for mask synthesis when the input is not a PNG and Sharp is unavailable. Optional.",
+    })),
+    size: Type.Optional(Type.String({
+        description: "Output size. Standard: 1024x1024, 1536x1024, 1024x1536, 1792x1024, 1024x1792, or auto. gpt-image-2 also accepts arbitrary WxH divisible by 16 with aspect ratio 1:3 to 3:1.",
+    })),
+    quality: Type.Optional(Type.Union([
+        Type.Literal("low"),
+        Type.Literal("medium"),
+        Type.Literal("high"),
+        Type.Literal("auto"),
+    ], {
+        description: "Output quality. Higher quality is slower and more expensive. Defaults to auto.",
+    })),
+    n: Type.Optional(Type.Integer({
+        description: "Number of images to produce (1-4). Defaults to 1.",
+        minimum: 1,
+        maximum: 4,
+    })),
+});
+export const painterTool = createTool({
+    name: "painter",
+    description: "Generate or edit images via an image model (default gpt-image-2). Use for UI mockups, app icons, illustrations, and editing existing images (e.g. redacting a screenshot). Outputs are persisted to disk and returned as absolute paths; reference them by path in later turns. Requires OPENAI_API_KEY.",
+    schema: painterSchema,
+    maxRetries: 1,
+    retryDelayMs: 2000,
+    shouldRetry: isTransientImageError,
+    getToolUseSummary: (params) => `painter ${params.mode}`,
+    getActivityDescription: (params) => params.mode === "edit" ? "Editing image" : "Generating image",
+    async run(params, { respond, signal }) {
+        const providerName = resolvePainterProvider();
+        const apiKeyEnv = providerName === "flux" ? "FAL_KEY" : "OPENAI_API_KEY";
+        const apiKey = process.env[apiKeyEnv];
+        if (!apiKey) {
+            throw new Error(`Painter provider "${providerName}" requires ${apiKeyEnv} to be set in the environment where the agent runs.`);
+        }
+        if (params.mode === "edit" &&
+            (!params.images || params.images.length === 0)) {
+            throw new Error("Painter edit mode requires at least one input image path (the `images` parameter).");
+        }
+        const budget = getPainterBudget().checkAndReserve({
+            model: resolvePainterModel(),
+            size: params.size,
+            quality: params.quality,
+            n: params.n,
+        });
+        if (!budget.ok) {
+            throw new Error(budget.reason ?? "painter cost ceiling exceeded");
+        }
+        if (budget.enforced) {
+            logger.info("painter budget", {
+                estimated: budget.estimatedCents,
+                cumulative: budget.cumulativeCents,
+                ceiling: budget.ceilingCents,
+            });
+        }
+        const provider = createImageProvider({
+            provider: providerName,
+            apiKey,
+            baseURL: process.env.MAESTRO_PAINTER_BASE_URL?.trim() || undefined,
+            model: resolvePainterModel(),
+            writeImage: persistImage,
+        });
+        if (!provider.supports[params.mode]) {
+            throw new Error(params.mode === "edit"
+                ? `Painter provider "${provider.id}" does not support editing. Use the OpenAI provider (MAESTRO_PAINTER_PROVIDER=openai) for edits.`
+                : `Painter provider "${provider.id}" does not support generation.`);
+        }
+        // Combine the tool's abort signal with a hard timeout, without relying
+        // on AbortSignal.any so this works on any lib target.
+        const timeoutCtl = new AbortController();
+        const onCallerAbort = () => timeoutCtl.abort();
+        if (signal) {
+            if (signal.aborted) {
+                timeoutCtl.abort();
+            }
+            else {
+                signal.addEventListener("abort", onCallerAbort, { once: true });
+            }
+        }
+        const timer = setTimeout(() => timeoutCtl.abort(), painterTimeoutMs());
+        let synthesizedMask = null;
+        try {
+            const shared = {
+                prompt: params.prompt,
+                size: params.size,
+                quality: params.quality,
+                n: params.n,
+                signal: timeoutCtl.signal,
+            };
+            let maskPath = params.mask;
+            if (params.mode === "edit" && params.maskRegion) {
+                const built = await buildMaskPath(params.images ?? [], params.maskRegion, params.maskSize);
+                maskPath = built.maskPath;
+                synthesizedMask = built.maskPath;
+                logger.info("synthesized edit mask", {
+                    source: built.source,
+                    ...built.dimensions,
+                });
+            }
+            const result = params.mode === "edit"
+                ? await provider.edit({
+                    ...shared,
+                    images: params.images ?? [],
+                    maskPath,
+                })
+                : await provider.generate(shared);
+            const lines = result.images.map((img, i) => `  ${i + 1}. ${img.path}${img.revisedPrompt ? `\n      revised prompt: ${img.revisedPrompt}` : ""}`);
+            logger.info("painter produced images", {
+                mode: params.mode,
+                model: result.model,
+                count: result.images.length,
+            });
+            return respond
+                .text([
+                `Painter (${result.provider}/${result.model}) produced ${result.images.length} image(s):`,
+                ...lines,
+                "Outputs are on disk. Reference them by the absolute paths above.",
+            ].join("\n"))
+                .detail({
+                provider: result.provider,
+                model: result.model,
+                mode: params.mode,
+                paths: result.images.map((i) => i.path),
+            });
+        }
+        catch (err) {
+            // The provider did not produce images (transient retry exhausted,
+            // timeout, content-policy, mask failure, unsupported mode). Release
+            // the reserved estimate so failed calls don't permanently consume
+            // the spend ceiling — the provider did not charge for these.
+            if (budget.enforced && budget.estimatedCents) {
+                getPainterBudget().release(budget.estimatedCents);
+            }
+            throw err;
+        }
+        finally {
+            clearTimeout(timer);
+            signal?.removeEventListener("abort", onCallerAbort);
+            // Best-effort cleanup of the synthesized mask; user-supplied mask
+            // paths are left untouched.
+            if (synthesizedMask) {
+                await unlink(synthesizedMask).catch(() => { });
+            }
+        }
+    },
+});
+//# sourceMappingURL=painter.js.map

package/dist/tools/painter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"painter.js","sourceRoot":"","sources":["../../src/tools/painter.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomBytes } from \"node:crypto\";\nimport { readFile, unlink } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\nimport { join, resolve } from \"node:path\";\nimport { Type } from \"@sinclair/typebox\";\nimport { getPainterBudget } from \"../services/image-providers/cost.js\";\nimport { createImageProvider } from \"../services/image-providers/index.js\";\nimport {\n\ttype ImageDimensions,\n\ttype MaskRegion,\n\tencodeMaskPng,\n\treadPngDimensions,\n} from \"../services/image-providers/masks.js\";\nimport type {\n\tImageQuality,\n\tImageSize,\n} from \"../services/image-providers/types.js\";\nimport { writeTextFileAtomic } from \"../utils/fs.js\";\nimport { createLogger } from \"../utils/logger.js\";\nimport { getImageMetadata } from \"./image-processor.js\";\nimport { createTool } from \"./tool-dsl.js\";\n\nconst logger = createLogger(\"tools:painter\");\n\nconst DEFAULT_PAINTER_TIMEOUT_MS = 180_000;\nconst DEFAULT_MODEL = \"gpt-image-2\";\n\nexport function painterTimeoutMs(): number {\n\tconst raw = process.env.MAESTRO_PAINTER_TIMEOUT_MS;\n\tif (!raw) return DEFAULT_PAINTER_TIMEOUT_MS;\n\tconst parsed = Number.parseInt(raw, 10);\n\treturn Number.isFinite(parsed) && parsed > 0\n\t\t? parsed\n\t\t: DEFAULT_PAINTER_TIMEOUT_MS;\n}\n\nexport function painterOutputDir(): string {\n\tconst override = process.env.MAESTRO_PAINTER_OUTPUT_DIR?.trim();\n\tif (override) return resolve(override);\n\treturn join(homedir(), \".maestro\", \"assets\", \"painter\");\n}\n\nexport function resolvePainterModel(): string {\n\treturn process.env.MAESTRO_PAINTER_MODEL?.trim() || DEFAULT_MODEL;\n}\n\n/** Resolve the image provider. \"openai\" (default) or \"flux\" via fal.ai. */\nexport function resolvePainterProvider(): \"openai\" | \"flux\" {\n\tconst raw = process.env.MAESTRO_PAINTER_PROVIDER?.trim().toLowerCase();\n\treturn raw === \"flux\" ? \"flux\" : \"openai\";\n}\n\nexport async function persistImage(\n\tbytes: Buffer,\n\text: string,\n): Promise<{ path: string }> {\n\tconst dir = painterOutputDir();\n\tconst name = `painter-${Date.now()}-${randomBytes(4).toString(\"hex\")}.${ext}`;\n\tconst path = join(dir, name);\n\twriteTextFileAtomic(path, bytes.toString(\"latin1\"), { encoding: \"latin1\" });\n\treturn { path };\n}\n\n/** Errno-style codes that indicate a transient network fault worth retrying. */\nconst TRANSIENT_ERRNO_CODES = new Set([\n\t\"ETIMEDOUT\",\n\t\"ECONNRESET\",\n\t\"ENOTFOUND\",\n\t\"ECONNREFUSED\",\n\t\"EAI_AGAIN\",\n\t\"EPIPE\",\n\t\"EHOSTUNREACH\",\n\t\"ENETUNREACH\",\n]);\n\n/**\n * Classify whether an image-API failure is worth one retry. Image generation\n * is expensive, so we retry only on clearly transient network/rate-limit\n * faults and never on validation or content-policy rejections.\n */\nexport function isTransientImageError(err: unknown): boolean {\n\tconst code = (err as { code?: unknown })?.code;\n\tif (\n\t\ttypeof code === \"string\" &&\n\t\tTRANSIENT_ERRNO_CODES.has(code.toUpperCase())\n\t) {\n\t\treturn true;\n\t}\n\tconst msg = err instanceof Error ? err.message : String(err);\n\treturn /rate limit|too many requests|timeout|timed out|econnreset|enotfound|etimedout|econnrefused|service unavailable|bad gateway|5\\d{2}/i.test(\n\t\tmsg,\n\t);\n}\n\nexport type MaskDimensionSource = \"png-header\" | \"sharp\" | \"explicit\";\n\n/**\n * Resolve a pixel bounding box into a mask file path, writing the synthesized\n * mask into the painter output directory. Dimensions come from (in order):\n * the PNG header (no deps), the optional `sharp` package, or an explicit\n * caller-supplied size. Returns the temp mask path plus how dims were found.\n */\nexport async function buildMaskPath(\n\timages: string[],\n\tregion: MaskRegion,\n\texplicitSize?: ImageDimensions,\n): Promise<{\n\tmaskPath: string;\n\tdimensions: ImageDimensions;\n\tsource: MaskDimensionSource;\n}> {\n\tif (images.length === 0) {\n\t\tthrow new Error(\"mask synthesis requires at least one input image path.\");\n\t}\n\tconst inputPath = images[0];\n\tif (!inputPath) {\n\t\tthrow new Error(\"mask synthesis received an undefined input image path.\");\n\t}\n\tconst buf = await readFile(inputPath);\n\n\tlet dimensions: ImageDimensions | null = readPngDimensions(buf);\n\tlet source: MaskDimensionSource = \"png-header\";\n\n\tif (!dimensions) {\n\t\tif (explicitSize) {\n\t\t\tdimensions = explicitSize;\n\t\t\tsource = \"explicit\";\n\t\t} else {\n\t\t\tconst meta = await getImageMetadata(buf);\n\t\t\tif (meta?.width && meta.height) {\n\t\t\t\tdimensions = { width: meta.width, height: meta.height };\n\t\t\t\tsource = \"sharp\";\n\t\t\t}\n\t\t}\n\t}\n\n\tif (!dimensions) {\n\t\tthrow new Error(\n\t\t\t\"Could not determine input image dimensions for mask synthesis. Use a PNG input, enable Sharp, or pass maskSize explicitly.\",\n\t\t);\n\t}\n\n\tconst maskBuf = encodeMaskPng(dimensions, region);\n\tconst dir = painterOutputDir();\n\tconst maskPath = join(\n\t\tdir,\n\t\t`mask-${Date.now()}-${randomBytes(4).toString(\"hex\")}.png`,\n\t);\n\twriteTextFileAtomic(maskPath, maskBuf.toString(\"latin1\"), {\n\t\tencoding: \"latin1\",\n\t});\n\treturn { maskPath, dimensions, source };\n}\n\nconst painterSchema = Type.Object({\n\tmode: Type.Union([Type.Literal(\"generate\"), Type.Literal(\"edit\")], {\n\t\tdescription:\n\t\t\t\"generate = create a new image from a text prompt. edit = modify one or more existing images using a prompt (and optional mask).\",\n\t}),\n\tprompt: Type.String({\n\t\tdescription:\n\t\t\t\"The image prompt. For edit mode, describe the desired change. Be concrete about subject, style, composition, and any text to render.\",\n\t}),\n\timages: Type.Optional(\n\t\tType.Array(Type.String(), {\n\t\t\tdescription:\n\t\t\t\t\"Edit mode only. 1-3 absolute or workspace-relative paths to input images to edit.\",\n\t\t}),\n\t),\n\tmask: Type.Optional(\n\t\tType.String({\n\t\t\tdescription:\n\t\t\t\t\"Edit mode only. Path to a mask image; transparent regions mark areas the model may change. Omit to edit the whole image. Mutually exclusive with maskRegion (which synthesizes the mask for you).\",\n\t\t}),\n\t),\n\tmaskRegion: Type.Optional(\n\t\tType.Object(\n\t\t\t{\n\t\t\t\tx: Type.Number({ description: \"Region left edge, in pixels.\" }),\n\t\t\t\ty: Type.Number({ description: \"Region top edge, in pixels.\" }),\n\t\t\t\twidth: Type.Number({ description: \"Region width, in pixels.\" }),\n\t\t\t\theight: Type.Number({ description: \"Region height, in pixels.\" }),\n\t\t\t},\n\t\t\t{\n\t\t\t\tdescription:\n\t\t\t\t\t\"Edit mode only. A pixel bounding box; the mask is synthesized automatically (transparent = editable). Coordinates outside the image are clipped.\",\n\t\t\t},\n\t\t),\n\t),\n\tmaskSize: Type.Optional(\n\t\tType.Object(\n\t\t\t{\n\t\t\t\twidth: Type.Integer({ minimum: 1 }),\n\t\t\t\theight: Type.Integer({ minimum: 1 }),\n\t\t\t},\n\t\t\t{\n\t\t\t\tdescription:\n\t\t\t\t\t\"Explicit input image dimensions, used only for mask synthesis when the input is not a PNG and Sharp is unavailable. Optional.\",\n\t\t\t},\n\t\t),\n\t),\n\tsize: Type.Optional(\n\t\tType.String({\n\t\t\tdescription:\n\t\t\t\t\"Output size. Standard: 1024x1024, 1536x1024, 1024x1536, 1792x1024, 1024x1792, or auto. gpt-image-2 also accepts arbitrary WxH divisible by 16 with aspect ratio 1:3 to 3:1.\",\n\t\t}),\n\t),\n\tquality: Type.Optional(\n\t\tType.Union(\n\t\t\t[\n\t\t\t\tType.Literal(\"low\"),\n\t\t\t\tType.Literal(\"medium\"),\n\t\t\t\tType.Literal(\"high\"),\n\t\t\t\tType.Literal(\"auto\"),\n\t\t\t],\n\t\t\t{\n\t\t\t\tdescription:\n\t\t\t\t\t\"Output quality. Higher quality is slower and more expensive. Defaults to auto.\",\n\t\t\t},\n\t\t),\n\t),\n\tn: Type.Optional(\n\t\tType.Integer({\n\t\t\tdescription: \"Number of images to produce (1-4). Defaults to 1.\",\n\t\t\tminimum: 1,\n\t\t\tmaximum: 4,\n\t\t}),\n\t),\n});\n\nexport interface PainterToolDetails {\n\tprovider: string;\n\tmodel: string;\n\tmode: \"generate\" | \"edit\";\n\tpaths: string[];\n}\n\nexport const painterTool = createTool<typeof painterSchema, PainterToolDetails>(\n\t{\n\t\tname: \"painter\",\n\t\tdescription:\n\t\t\t\"Generate or edit images via an image model (default gpt-image-2). Use for UI mockups, app icons, illustrations, and editing existing images (e.g. redacting a screenshot). Outputs are persisted to disk and returned as absolute paths; reference them by path in later turns. Requires OPENAI_API_KEY.\",\n\t\tschema: painterSchema,\n\t\tmaxRetries: 1,\n\t\tretryDelayMs: 2000,\n\t\tshouldRetry: isTransientImageError,\n\t\tgetToolUseSummary: (params) => `painter ${params.mode}`,\n\t\tgetActivityDescription: (params) =>\n\t\t\tparams.mode === \"edit\" ? \"Editing image\" : \"Generating image\",\n\t\tasync run(params, { respond, signal }) {\n\t\t\tconst providerName = resolvePainterProvider();\n\t\t\tconst apiKeyEnv = providerName === \"flux\" ? \"FAL_KEY\" : \"OPENAI_API_KEY\";\n\t\t\tconst apiKey = process.env[apiKeyEnv];\n\t\t\tif (!apiKey) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`Painter provider \"${providerName}\" requires ${apiKeyEnv} to be set in the environment where the agent runs.`,\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tif (\n\t\t\t\tparams.mode === \"edit\" &&\n\t\t\t\t(!params.images || params.images.length === 0)\n\t\t\t) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t\"Painter edit mode requires at least one input image path (the `images` parameter).\",\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tconst budget = getPainterBudget().checkAndReserve({\n\t\t\t\tmodel: resolvePainterModel(),\n\t\t\t\tsize: params.size,\n\t\t\t\tquality: params.quality,\n\t\t\t\tn: params.n,\n\t\t\t});\n\t\t\tif (!budget.ok) {\n\t\t\t\tthrow new Error(budget.reason ?? \"painter cost ceiling exceeded\");\n\t\t\t}\n\t\t\tif (budget.enforced) {\n\t\t\t\tlogger.info(\"painter budget\", {\n\t\t\t\t\testimated: budget.estimatedCents,\n\t\t\t\t\tcumulative: budget.cumulativeCents,\n\t\t\t\t\tceiling: budget.ceilingCents,\n\t\t\t\t});\n\t\t\t}\n\n\t\t\tconst provider = createImageProvider({\n\t\t\t\tprovider: providerName,\n\t\t\t\tapiKey,\n\t\t\t\tbaseURL: process.env.MAESTRO_PAINTER_BASE_URL?.trim() || undefined,\n\t\t\t\tmodel: resolvePainterModel(),\n\t\t\t\twriteImage: persistImage,\n\t\t\t});\n\n\t\t\tif (!provider.supports[params.mode]) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\tparams.mode === \"edit\"\n\t\t\t\t\t\t? `Painter provider \"${provider.id}\" does not support editing. Use the OpenAI provider (MAESTRO_PAINTER_PROVIDER=openai) for edits.`\n\t\t\t\t\t\t: `Painter provider \"${provider.id}\" does not support generation.`,\n\t\t\t\t);\n\t\t\t}\n\n\t\t\t// Combine the tool's abort signal with a hard timeout, without relying\n\t\t\t// on AbortSignal.any so this works on any lib target.\n\t\t\tconst timeoutCtl = new AbortController();\n\t\t\tconst onCallerAbort = () => timeoutCtl.abort();\n\t\t\tif (signal) {\n\t\t\t\tif (signal.aborted) {\n\t\t\t\t\ttimeoutCtl.abort();\n\t\t\t\t} else {\n\t\t\t\t\tsignal.addEventListener(\"abort\", onCallerAbort, { once: true });\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst timer = setTimeout(() => timeoutCtl.abort(), painterTimeoutMs());\n\n\t\t\tlet synthesizedMask: string | null = null;\n\t\t\ttry {\n\t\t\t\tconst shared = {\n\t\t\t\t\tprompt: params.prompt,\n\t\t\t\t\tsize: params.size as ImageSize | undefined,\n\t\t\t\t\tquality: params.quality as ImageQuality | undefined,\n\t\t\t\t\tn: params.n,\n\t\t\t\t\tsignal: timeoutCtl.signal,\n\t\t\t\t};\n\n\t\t\t\tlet maskPath = params.mask;\n\t\t\t\tif (params.mode === \"edit\" && params.maskRegion) {\n\t\t\t\t\tconst built = await buildMaskPath(\n\t\t\t\t\t\tparams.images ?? [],\n\t\t\t\t\t\tparams.maskRegion,\n\t\t\t\t\t\tparams.maskSize,\n\t\t\t\t\t);\n\t\t\t\t\tmaskPath = built.maskPath;\n\t\t\t\t\tsynthesizedMask = built.maskPath;\n\t\t\t\t\tlogger.info(\"synthesized edit mask\", {\n\t\t\t\t\t\tsource: built.source,\n\t\t\t\t\t\t...built.dimensions,\n\t\t\t\t\t});\n\t\t\t\t}\n\n\t\t\t\tconst result =\n\t\t\t\t\tparams.mode === \"edit\"\n\t\t\t\t\t\t? await provider.edit({\n\t\t\t\t\t\t\t\t...shared,\n\t\t\t\t\t\t\t\timages: params.images ?? [],\n\t\t\t\t\t\t\t\tmaskPath,\n\t\t\t\t\t\t\t})\n\t\t\t\t\t\t: await provider.generate(shared);\n\n\t\t\t\tconst lines = result.images.map(\n\t\t\t\t\t(img, i) =>\n\t\t\t\t\t\t`  ${i + 1}. ${img.path}${img.revisedPrompt ? `\\n      revised prompt: ${img.revisedPrompt}` : \"\"}`,\n\t\t\t\t);\n\n\t\t\t\tlogger.info(\"painter produced images\", {\n\t\t\t\t\tmode: params.mode,\n\t\t\t\t\tmodel: result.model,\n\t\t\t\t\tcount: result.images.length,\n\t\t\t\t});\n\n\t\t\t\treturn respond\n\t\t\t\t\t.text(\n\t\t\t\t\t\t[\n\t\t\t\t\t\t\t`Painter (${result.provider}/${result.model}) produced ${result.images.length} image(s):`,\n\t\t\t\t\t\t\t...lines,\n\t\t\t\t\t\t\t\"Outputs are on disk. Reference them by the absolute paths above.\",\n\t\t\t\t\t\t].join(\"\\n\"),\n\t\t\t\t\t)\n\t\t\t\t\t.detail({\n\t\t\t\t\t\tprovider: result.provider,\n\t\t\t\t\t\tmodel: result.model,\n\t\t\t\t\t\tmode: params.mode,\n\t\t\t\t\t\tpaths: result.images.map((i) => i.path),\n\t\t\t\t\t});\n\t\t\t} catch (err) {\n\t\t\t\t// The provider did not produce images (transient retry exhausted,\n\t\t\t\t// timeout, content-policy, mask failure, unsupported mode). Release\n\t\t\t\t// the reserved estimate so failed calls don't permanently consume\n\t\t\t\t// the spend ceiling — the provider did not charge for these.\n\t\t\t\tif (budget.enforced && budget.estimatedCents) {\n\t\t\t\t\tgetPainterBudget().release(budget.estimatedCents);\n\t\t\t\t}\n\t\t\t\tthrow err;\n\t\t\t} finally {\n\t\t\t\tclearTimeout(timer);\n\t\t\t\tsignal?.removeEventListener(\"abort\", onCallerAbort);\n\t\t\t\t// Best-effort cleanup of the synthesized mask; user-supplied mask\n\t\t\t\t// paths are left untouched.\n\t\t\t\tif (synthesizedMask) {\n\t\t\t\t\tawait unlink(synthesizedMask).catch(() => {});\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\t},\n);\n"]}

package/dist/tools/typebox-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typebox-tool.d.ts","sourceRoot":"","sources":["../../src/tools/typebox-tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,KAAK,EACX,SAAS,EACT,eAAe,EACf,eAAe,EACf,MAAM,mBAAmB,CAAC;AAK3B,KAAK,aAAa,CAAC,OAAO,IACvB,eAAe,CAAC,OAAO,CAAC,GACxB,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;AAErC,UAAU,wBAAwB,CAAC,MAAM,SAAS,OAAO,EAAE,OAAO;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAC1C,OAAO,EAAE,CACR,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EACtB,MAAM,CAAC,EAAE,WAAW,KAChB,aAAa,CAAC,OAAO,CAAC,CAAC;CAC5B;AAED,wBAAgB,iBAAiB,CAAC,MAAM,SAAS,OAAO,EAAE,OAAO,GAAG,SAAS,EAC5E,OAAO,EAAE,wBAAwB,CAAC,MAAM,EAAE,OAAO,CAAC,GAChD,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAyG5B"}
+{"version":3,"file":"typebox-tool.d.ts","sourceRoot":"","sources":["../../src/tools/typebox-tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,KAAK,EACX,SAAS,EACT,eAAe,EACf,eAAe,EACf,MAAM,mBAAmB,CAAC;AAI3B,KAAK,aAAa,CAAC,OAAO,IACvB,eAAe,CAAC,OAAO,CAAC,GACxB,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;AAErC,UAAU,wBAAwB,CAAC,MAAM,SAAS,OAAO,EAAE,OAAO;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAC1C,OAAO,EAAE,CACR,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EACtB,MAAM,CAAC,EAAE,WAAW,KAChB,aAAa,CAAC,OAAO,CAAC,CAAC;CAC5B;AAED,wBAAgB,iBAAiB,CAAC,MAAM,SAAS,OAAO,EAAE,OAAO,GAAG,SAAS,EAC5E,OAAO,EAAE,wBAAwB,CAAC,MAAM,EAAE,OAAO,CAAC,GAChD,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAyG5B"}

package/dist/tools/typebox-tool.js

@@ -1,5 +1,5 @@
 import { performance } from "node:perf_hooks";
-import { getSkillArtifactMetadataFromDetails } from "../skills/artifact-metadata.js";
+import { getSkillArtifactMetadataFromDetails } from "../agent/skill-artifact-metadata.js";
 import { logToolFailure, recordToolExecution } from "../telemetry.js";
 import { compileTypeboxSchema } from "../utils/typebox-ajv.js";
 export function createTypeboxTool(options) {