@mastra/core 1.9.0 → 1.10.0

package/dist/{chunk-SEKQJ447.js → chunk-ACAILOJE.js}

@@ -1,4 +1,4 @@
-import { createTool } from './chunk-ZVWVQ6MG.js';
+import { createTool } from './chunk-CY4ZWL2X.js';
 import { MastraBase } from './chunk-WCAFTXGK.js';
 import { RegisteredLogger } from './chunk-X2WMFSPB.js';
 import * as nodePath from 'path';
@@ -14,10 +14,9 @@ import { pathToFileURL } from 'url';
 import { execFileSync } from 'child_process';
 import * as crypto from 'crypto';
 import { createHash } from 'crypto';
-import { execa } from 'execa';
 import { Readable, Writable } from 'stream';
 import matter from 'gray-matter';
-import { z } from 'zod';
+import z$1, { z } from 'zod';
 import ignore from 'ignore';
 
 // src/workspace/errors.ts
@@ -2317,6 +2316,35 @@ var FilesystemNotMountableError = class extends SandboxError {
     this.name = "FilesystemNotMountableError";
   }
 };
+
+// src/workspace/sandbox/execa.ts
+var cached;
+var loading;
+async function getExeca() {
+  if (cached) {
+    return cached;
+  }
+  if (!loading) {
+    loading = (async () => {
+      try {
+        const mod = "execa";
+        const execa = (await import(
+          /* @vite-ignore */
+          /* webpackIgnore: true */
+          mod
+        )).execa;
+        cached = execa;
+        return execa;
+      } catch (err) {
+        throw new Error(
+          "execa is required for local process execution but is not available in this environment. LocalProcessManager is not supported in Cloudflare Workers or other non-Node runtimes.",
+          { cause: err }
+        );
+      }
+    })();
+  }
+  return loading;
+}
 var ProcessHandle = class {
   /** The command that was spawned (set by the process manager) */
   command;
@@ -2598,6 +2626,7 @@ var LocalProcessManager = class extends SandboxProcessManager {
       // Don't extend process.env — the sandbox controls the full environment via buildEnv().
       extendEnv: false
     };
+    const execa = await getExeca();
     const subprocess = execa(wrapped.command, wrapped.args, execaOptions);
     if (!subprocess.pid) {
       const result = await subprocess;
@@ -5797,6 +5826,116 @@ async function publishSkillFromSource(source, skillPath, blobStore) {
   await blobStore.putMany(result.blobs);
   return result;
 }
+function createSkillTools(skills) {
+  return {
+    skill: createSkillTool(skills),
+    skill_search: createSkillSearchTool(skills),
+    skill_read: createSkillReadTool(skills)
+  };
+}
+function createSkillTool(skills) {
+  const tool = createTool({
+    id: "skill",
+    description: "Activate a skill to load its full instructions. You should activate skills proactively when they are relevant to the user's request without asking for permission first.",
+    inputSchema: z$1.object({
+      name: z$1.string().describe("The name of the skill to activate")
+    }),
+    execute: async ({ name }) => {
+      const skill = await skills.get(name);
+      if (!skill) {
+        const skillsList = await skills.list();
+        const skillNames = skillsList.map((s) => s.name);
+        return `Skill "${name}" not found. Available skills: ${skillNames.join(", ")}`;
+      }
+      const parts = [skill.instructions];
+      if (skill.references?.length) {
+        parts.push(`
+
+## References
+${skill.references.map((r) => `- references/${r}`).join("\n")}`);
+      }
+      if (skill.scripts?.length) {
+        parts.push(`
+
+## Scripts
+${skill.scripts.map((s) => `- scripts/${s}`).join("\n")}`);
+      }
+      if (skill.assets?.length) {
+        parts.push(`
+
+## Assets
+${skill.assets.map((a) => `- assets/${a}`).join("\n")}`);
+      }
+      return parts.join("");
+    }
+  });
+  return tool;
+}
+function createSkillSearchTool(skills) {
+  const tool = createTool({
+    id: "skill_search",
+    description: "Search across skill content to find relevant information. Useful when you need to find specific details within skills.",
+    inputSchema: z$1.object({
+      query: z$1.string().describe("The search query"),
+      skillNames: z$1.array(z$1.string()).optional().describe("Optional list of skill names to search within"),
+      topK: z$1.number().optional().describe("Maximum number of results to return (default: 5)")
+    }),
+    execute: async ({ query, skillNames, topK }) => {
+      const results = await skills.search(query, { topK, skillNames });
+      if (results.length === 0) {
+        return "No results found.";
+      }
+      return results.map((r) => {
+        const preview = r.content.substring(0, 200) + (r.content.length > 200 ? "..." : "");
+        const location = r.lineRange ? ` (lines ${r.lineRange.start}-${r.lineRange.end})` : "";
+        return `[${r.skillName}]${location} (score: ${r.score.toFixed(2)})
+${preview}`;
+      }).join("\n\n");
+    }
+  });
+  return tool;
+}
+function createSkillReadTool(skills) {
+  const tool = createTool({
+    id: "skill_read",
+    description: "Read a file from a skill directory (references, scripts, or assets). The path is relative to the skill root.",
+    inputSchema: z$1.object({
+      skillName: z$1.string().describe("The name of the skill"),
+      path: z$1.string().describe('Path to the file relative to the skill root (e.g. "references/colors.md", "scripts/run.sh")'),
+      startLine: z$1.number().optional().describe("Starting line number (1-indexed). If omitted, starts from the beginning."),
+      endLine: z$1.number().optional().describe("Ending line number (1-indexed, inclusive). If omitted, reads to the end.")
+    }),
+    execute: async ({ skillName, path: path7, startLine, endLine }) => {
+      if (!await skills.has(skillName)) {
+        return `Skill "${skillName}" not found.`;
+      }
+      let content = null;
+      content = await skills.getReference(skillName, path7);
+      if (content === null) content = await skills.getScript(skillName, path7);
+      if (content === null) content = await skills.getAsset(skillName, path7);
+      if (content === null) {
+        const refs = (await skills.listReferences(skillName)).map((f) => `references/${f}`);
+        const scripts = (await skills.listScripts(skillName)).map((f) => `scripts/${f}`);
+        const assets = (await skills.listAssets(skillName)).map((f) => `assets/${f}`);
+        const allFiles = [...refs, ...scripts, ...assets];
+        const fileList = allFiles.length > 0 ? `
+Available files: ${allFiles.join(", ")}` : "";
+        return `File "${path7}" not found in skill "${skillName}".${fileList}`;
+      }
+      const textContent = typeof content === "string" ? content : content.toString("utf-8");
+      if (textContent.slice(0, 1e3).includes("\0")) {
+        const skill = await skills.get(skillName);
+        const fullPath = skill ? `${skill.path}/${path7}` : path7;
+        const size = typeof content === "string" ? Buffer.byteLength(content) : content.length;
+        return `Binary file: ${fullPath} (${size} bytes)`;
+      }
+      content = textContent;
+      const result = extractLines(content, startLine, endLine);
+      return result.content;
+    }
+  });
+  return tool;
+}
 
 // src/workspace/workspace.ts
 var Workspace = class {
@@ -6438,6 +6577,7 @@ async function loadAstGrep() {
       try {
         const moduleName = "@ast-grep/napi";
         const mod = await import(
+          /* @vite-ignore */
           /* webpackIgnore: true */
           moduleName
         );
@@ -6808,8 +6948,8 @@ Usage:
 // src/utils/tiktoken.ts
 var GLOBAL_KEY = "__mastraTiktoken";
 async function getTiktoken() {
-  const cached = globalThis[GLOBAL_KEY];
-  if (cached) return cached;
+  const cached2 = globalThis[GLOBAL_KEY];
+  if (cached2) return cached2;
   const { Tiktoken: TiktokenClass } = await import('js-tiktoken/lite');
   const o200k_base = (await import('js-tiktoken/ranks/o200k_base')).default;
   const enc = new TiktokenClass(o200k_base);
@@ -6842,71 +6982,28 @@ function applyTail(output, tail) {
   return `[showing last ${n} of ${lines.length} lines]
 ${body}`;
 }
-async function countTokens(output) {
-  const tiktoken = await getTiktoken();
-  return tiktoken.encode(output, "all").length;
-}
 async function applyTokenLimit(output, limit = DEFAULT_MAX_OUTPUT_TOKENS, from = "start") {
   if (!output) return output;
-  const tokens = await countTokens(output);
-  if (tokens <= limit) return output;
-  const trailingNewline = output.endsWith("\n");
-  const lines = (trailingNewline ? output.slice(0, -1) : output).split("\n");
-  const kept = [];
-  let keptTokens = 0;
-  if (from === "start") {
-    for (let i = lines.length - 1; i >= 0; i--) {
-      const lineTokens = await countTokens(lines[i]);
-      if (keptTokens + lineTokens > limit && kept.length > 0) break;
-      kept.unshift(lines[i]);
-      keptTokens += lineTokens;
-    }
-  } else {
-    for (let i = 0; i < lines.length; i++) {
-      const lineTokens = await countTokens(lines[i]);
-      if (keptTokens + lineTokens > limit && kept.length > 0) break;
-      kept.push(lines[i]);
-      keptTokens += lineTokens;
-    }
-  }
-  if (kept.length >= lines.length) return output;
-  const body = kept.join("\n") + (trailingNewline && from === "start" ? "\n" : "");
+  const tiktoken = await getTiktoken();
+  const allTokens = tiktoken.encode(output, "all");
+  if (allTokens.length <= limit) return output;
+  const kept = from === "start" ? tiktoken.decode(allTokens.slice(-limit)) : tiktoken.decode(allTokens.slice(0, limit));
   const position = from === "start" ? "last" : "first";
-  return from === "start" ? `[output truncated: showing ${position} ~${keptTokens} of ~${tokens} tokens]
-${body}` : `${body}
-[output truncated: showing ${position} ~${keptTokens} of ~${tokens} tokens]`;
+  return from === "start" ? `[output truncated: showing ${position} ~${limit} of ~${allTokens.length} tokens]
+${kept}` : `${kept}
+[output truncated: showing ${position} ~${limit} of ~${allTokens.length} tokens]`;
 }
 async function applyTokenLimitSandwich(output, limit = DEFAULT_MAX_OUTPUT_TOKENS, headRatio = 0.1) {
   if (!output) return output;
-  const tokens = await countTokens(output);
-  if (tokens <= limit) return output;
-  const trailingNewline = output.endsWith("\n");
-  const lines = (trailingNewline ? output.slice(0, -1) : output).split("\n");
+  const tiktoken = await getTiktoken();
+  const allTokens = tiktoken.encode(output, "all");
+  if (allTokens.length <= limit) return output;
   const headBudget = Math.floor(limit * headRatio);
   const tailBudget = limit - headBudget;
-  const headLines = [];
-  let headTokens = 0;
-  for (let i = 0; i < lines.length; i++) {
-    const lineTokens = await countTokens(lines[i]);
-    if (headTokens + lineTokens > headBudget && headLines.length > 0) break;
-    headLines.push(lines[i]);
-    headTokens += lineTokens;
-  }
-  const tailLines = [];
-  let tailTokens = 0;
-  for (let i = lines.length - 1; i >= headLines.length; i--) {
-    const lineTokens = await countTokens(lines[i]);
-    if (tailTokens + lineTokens > tailBudget && tailLines.length > 0) break;
-    tailLines.unshift(lines[i]);
-    tailTokens += lineTokens;
-  }
-  if (headLines.length + tailLines.length >= lines.length) return output;
-  const omitted = lines.length - headLines.length - tailLines.length;
-  const head = headLines.join("\n");
-  const tail = tailLines.join("\n") + (trailingNewline ? "\n" : "");
-  return `${head}
-[...${omitted} lines truncated \u2014 showing first ~${headTokens} + last ~${tailTokens} of ~${tokens} tokens...]
-${tail}`;
+  const head = headBudget > 0 ? tiktoken.decode(allTokens.slice(0, headBudget)) : "";
+  const tail = tailBudget > 0 ? tiktoken.decode(allTokens.slice(-tailBudget)) : "";
+  const notice = `[...output truncated \u2014 showing first ~${headBudget} + last ~${tailBudget} of ~${allTokens.length} tokens...]`;
+  return [head, notice, tail].filter(Boolean).join("\n");
 }
 async function truncateOutput(output, tail, tokenLimit, tokenFrom) {
   const tailed = applyTail(output, tail);
@@ -6918,7 +7015,7 @@ async function truncateOutput(output, tail, tokenLimit, tokenFrom) {
 // src/workspace/tools/execute-command.ts
 var executeCommandInputSchema = z.object({
   command: z.string().describe('The shell command to execute (e.g., "npm install", "ls -la src/", "cat file.txt | grep error")'),
-  timeout: z.number().nullish().describe("Maximum execution time in milliseconds. Example: 60000 for 1 minute."),
+  timeout: z.number().nullish().describe("Maximum execution time in seconds. Example: 60 for 1 minute."),
   cwd: z.string().nullish().describe("Working directory for the command"),
   tail: z.number().nullish().describe(
     `For foreground commands: limit output to the last N lines, similar to tail -n. Defaults to ${DEFAULT_TAIL_LINES}. Use 0 for no limit.`
@@ -6943,7 +7040,8 @@ function extractTailPipe(command) {
   return { command };
 }
 async function executeCommand(input, context) {
-  let { command, timeout, cwd, tail } = input;
+  let { command, cwd, tail } = input;
+  const timeout = input.timeout != null ? input.timeout * 1e3 : void 0;
   const background = input.background;
   const { workspace, sandbox } = requireSandbox(context);
   if (!background) {
@@ -7059,7 +7157,7 @@ Examples:
 Usage:
 - Commands run in a shell, so pipes, redirects, and chaining (&&, ||, ;) all work.
 - Always quote file paths that contain spaces (e.g., cd "/path/with spaces").
-- Use the timeout parameter to limit execution time. Behavior when omitted depends on the sandbox provider.
+- Use the timeout parameter (in seconds) to limit execution time. Behavior when omitted depends on the sandbox provider.
 - Optionally use cwd to override the working directory. Commands run from the sandbox default if omitted.`;
 var executeCommandTool = createTool({
   id: WORKSPACE_TOOLS.SANDBOX.EXECUTE_COMMAND,
@@ -7865,6 +7963,6 @@ function createWorkspaceTools(workspace) {
   return tools;
 }
 
-export { BM25Index, CompositeFilesystem, CompositeVersionedSkillSource, DirectoryNotEmptyError, DirectoryNotFoundError, FileExistsError, FileNotFoundError, FileReadRequiredError, FilesystemError, FilesystemNotAvailableError, FilesystemNotMountableError, FilesystemNotReadyError, IsDirectoryError, IsolationUnavailableError, LocalFilesystem, LocalSandbox, LocalSkillSource, MastraFilesystem, MastraSandbox, MountError, MountManager, MountNotSupportedError, NotDirectoryError, PermissionError, ProcessHandle, SandboxError, SandboxExecutionError, SandboxFeatureNotSupportedError, SandboxNotAvailableError, SandboxNotReadyError, SandboxProcessManager, SandboxTimeoutError, SearchNotAvailableError, VersionedSkillSource, WORKSPACE_TOOLS, WORKSPACE_TOOLS_PREFIX, Workspace, WorkspaceError, WorkspaceNotAvailableError, WorkspaceNotReadyError, WorkspaceReadOnlyError, callLifecycle, collectSkillForPublish, createGlobMatcher, createWorkspaceTools, deleteFileTool, detectIsolation, editFileTool, executeCommandTool, extractGlobBase, extractLines, fileStatTool, getRecommendedIsolation, indexContentTool, isGlobPattern, isIsolationAvailable, listFilesTool, matchGlob, mkdirTool, publishSkillFromSource, readFileTool, requireFilesystem, requireSandbox, requireWorkspace, resolveToolConfig, searchTool, writeFileTool };
-//# sourceMappingURL=chunk-SEKQJ447.js.map
-//# sourceMappingURL=chunk-SEKQJ447.js.map
+export { BM25Index, CompositeFilesystem, CompositeVersionedSkillSource, DirectoryNotEmptyError, DirectoryNotFoundError, FileExistsError, FileNotFoundError, FileReadRequiredError, FilesystemError, FilesystemNotAvailableError, FilesystemNotMountableError, FilesystemNotReadyError, IsDirectoryError, IsolationUnavailableError, LocalFilesystem, LocalSandbox, LocalSkillSource, MastraFilesystem, MastraSandbox, MountError, MountManager, MountNotSupportedError, NotDirectoryError, PermissionError, ProcessHandle, SandboxError, SandboxExecutionError, SandboxFeatureNotSupportedError, SandboxNotAvailableError, SandboxNotReadyError, SandboxProcessManager, SandboxTimeoutError, SearchNotAvailableError, VersionedSkillSource, WORKSPACE_TOOLS, WORKSPACE_TOOLS_PREFIX, Workspace, WorkspaceError, WorkspaceNotAvailableError, WorkspaceNotReadyError, WorkspaceReadOnlyError, callLifecycle, collectSkillForPublish, createGlobMatcher, createSkillTools, createWorkspaceTools, deleteFileTool, detectIsolation, editFileTool, executeCommandTool, extractGlobBase, fileStatTool, getRecommendedIsolation, indexContentTool, isGlobPattern, isIsolationAvailable, listFilesTool, matchGlob, mkdirTool, publishSkillFromSource, readFileTool, requireFilesystem, requireSandbox, requireWorkspace, resolveToolConfig, searchTool, writeFileTool };
+//# sourceMappingURL=chunk-ACAILOJE.js.map
+//# sourceMappingURL=chunk-ACAILOJE.js.map