@elisym/sdk 0.12.3 → 0.12.5

package/dist/skills.js

@@ -1,7 +1,8 @@
 import { spawn } from 'node:child_process';
 import { StringDecoder } from 'node:string_decoder';
+import { readFile } from 'node:fs/promises';
+import { dirname, resolve, relative, sep, join } from 'node:path';
 import { readdirSync, statSync, readFileSync } from 'node:fs';
-import { join } from 'node:path';
 import YAML from 'yaml';
 import Decimal from 'decimal.js-light';
 
@@ -22,9 +23,9 @@ function sleepWithSignal(ms, signal) {
     return Promise.reject(createAbortError());
   }
   if (!signal) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
+    return new Promise((resolve2) => setTimeout(resolve2, ms));
   }
-  return new Promise((resolve, reject) => {
+  return new Promise((resolve2, reject) => {
     const cleanup = () => {
       clearTimeout(timer);
       signal.removeEventListener("abort", onAbort);
@@ -35,7 +36,7 @@ function sleepWithSignal(ms, signal) {
     };
     const timer = setTimeout(() => {
       cleanup();
-      resolve();
+      resolve2();
     }, ms);
     signal.addEventListener("abort", onAbort, { once: true });
   });
@@ -302,14 +303,61 @@ function createLlmClient(config) {
   }
   return createAnthropicClient(config);
 }
-var MAX_TOOL_OUTPUT = 1e6;
-var TOOL_TIMEOUT_MS = 6e4;
+var MAX_SCRIPT_OUTPUT = 1e6;
+var DEFAULT_SCRIPT_TIMEOUT_MS = 6e4;
+function runScript(cmd, args, opts) {
+  return new Promise((resolveResult) => {
+    const maxOutput = opts.maxOutput ?? MAX_SCRIPT_OUTPUT;
+    const timeoutMs = opts.timeoutMs ?? DEFAULT_SCRIPT_TIMEOUT_MS;
+    const child = spawn(cmd, args, {
+      cwd: opts.cwd,
+      stdio: ["pipe", "pipe", "pipe"],
+      timeout: timeoutMs,
+      killSignal: "SIGKILL",
+      signal: opts.signal
+    });
+    let stdout = "";
+    let stderr = "";
+    const stdoutDecoder = new StringDecoder("utf8");
+    const stderrDecoder = new StringDecoder("utf8");
+    child.stdout?.on("data", (data) => {
+      if (stdout.length < maxOutput) {
+        stdout += stdoutDecoder.write(data);
+        if (stdout.length > maxOutput) {
+          stdout = stdout.slice(0, maxOutput);
+        }
+      }
+    });
+    child.stderr?.on("data", (data) => {
+      if (stderr.length < maxOutput) {
+        stderr += stderrDecoder.write(data);
+        if (stderr.length > maxOutput) {
+          stderr = stderr.slice(0, maxOutput);
+        }
+      }
+    });
+    child.on("close", (code) => {
+      stdout += stdoutDecoder.end();
+      stderr += stderrDecoder.end();
+      resolveResult({ stdout, stderr, code });
+    });
+    child.on("error", (err) => {
+      resolveResult({ stdout, stderr, code: null, spawnError: err });
+    });
+    if (child.stdin) {
+      child.stdin.on("error", () => {
+      });
+      child.stdin.end(opts.stdin ?? "");
+    }
+  });
+}
 var ScriptSkill = class {
   name;
   description;
   capabilities;
   priceSubunits;
   asset;
+  mode = "llm";
   image;
   imageFile;
   skillDir;
@@ -381,76 +429,163 @@ var ScriptSkill = class {
     }
     throw new Error(`Max tool rounds (${this.maxToolRounds}) exceeded`);
   }
-  runTool(toolDef, call, signal) {
-    return new Promise((resolve) => {
-      const args = [...toolDef.command];
-      const cmd = args.shift();
-      if (!cmd) {
-        resolve(`Error: tool "${toolDef.name}" has an empty command`);
-        return;
+  async runTool(toolDef, call, signal) {
+    const args = [...toolDef.command];
+    const cmd = args.shift();
+    if (!cmd) {
+      return `Error: tool "${toolDef.name}" has an empty command`;
+    }
+    const params = toolDef.parameters ?? [];
+    for (let index = 0; index < params.length; index++) {
+      const param = params[index];
+      if (!param) {
+        continue;
       }
-      const params = toolDef.parameters ?? [];
-      for (let index = 0; index < params.length; index++) {
-        const param = params[index];
-        if (!param) {
-          continue;
-        }
-        const value = call.arguments[param.name];
-        if (value === void 0) {
-          continue;
-        }
-        if (param.required && index === 0) {
-          args.push(String(value));
-        } else {
-          args.push(`--${param.name}`, String(value));
-        }
+      const value = call.arguments[param.name];
+      if (value === void 0) {
+        continue;
       }
-      const child = spawn(cmd, args, {
-        cwd: this.skillDir,
-        stdio: ["pipe", "pipe", "pipe"],
-        timeout: TOOL_TIMEOUT_MS,
-        killSignal: "SIGKILL",
-        signal
-      });
-      let stdout = "";
-      let stderr = "";
-      const stdoutDecoder = new StringDecoder("utf8");
-      const stderrDecoder = new StringDecoder("utf8");
-      child.stdout?.on("data", (data) => {
-        if (stdout.length < MAX_TOOL_OUTPUT) {
-          stdout += stdoutDecoder.write(data);
-          if (stdout.length > MAX_TOOL_OUTPUT) {
-            stdout = stdout.slice(0, MAX_TOOL_OUTPUT);
-          }
-        }
-      });
-      child.stderr?.on("data", (data) => {
-        if (stderr.length < MAX_TOOL_OUTPUT) {
-          stderr += stderrDecoder.write(data);
-          if (stderr.length > MAX_TOOL_OUTPUT) {
-            stderr = stderr.slice(0, MAX_TOOL_OUTPUT);
-          }
-        }
-      });
-      child.on("close", (code) => {
-        stdout += stdoutDecoder.end();
-        stderr += stderrDecoder.end();
-        if (code === 0) {
-          resolve(stdout.trim());
-          return;
-        }
-        this.logger.debug?.(
-          { tool: toolDef.name, code, stderrLen: stderr.length },
-          "skill tool exited non-zero"
-        );
-        resolve(`Error (exit ${code}): ${stderr.trim() || stdout.trim()}`);
-      });
-      child.on("error", (err) => {
-        resolve(`Error: ${err.message}`);
-      });
+      if (param.required && index === 0) {
+        args.push(String(value));
+      } else {
+        args.push(`--${param.name}`, String(value));
+      }
+    }
+    const result = await runScript(cmd, args, { cwd: this.skillDir, signal });
+    if (result.spawnError) {
+      return `Error: ${result.spawnError.message}`;
+    }
+    if (result.code === 0) {
+      return result.stdout.trim();
+    }
+    this.logger.debug?.(
+      { tool: toolDef.name, code: result.code, stderrLen: result.stderr.length },
+      "skill tool exited non-zero"
+    );
+    return `Error (exit ${result.code}): ${result.stderr.trim() || result.stdout.trim()}`;
+  }
+};
+var MAX_STATIC_FILE_SIZE = 256 * 1024;
+var StaticFileSkill = class {
+  name;
+  description;
+  capabilities;
+  priceSubunits;
+  asset;
+  mode = "static-file";
+  image;
+  imageFile;
+  outputFilePath;
+  constructor(params) {
+    this.name = params.name;
+    this.description = params.description;
+    this.capabilities = params.capabilities;
+    this.priceSubunits = params.priceSubunits;
+    this.asset = params.asset;
+    this.image = params.image;
+    this.imageFile = params.imageFile;
+    this.outputFilePath = params.outputFilePath;
+  }
+  async execute(_input, _ctx) {
+    const buffer = await readFile(this.outputFilePath);
+    if (buffer.length > MAX_STATIC_FILE_SIZE) {
+      throw new Error(
+        `static-file output exceeds ${MAX_STATIC_FILE_SIZE} bytes (got ${buffer.length})`
+      );
+    }
+    return { data: buffer.toString("utf-8") };
+  }
+};
+var StaticScriptSkill = class {
+  name;
+  description;
+  capabilities;
+  priceSubunits;
+  asset;
+  mode = "static-script";
+  image;
+  imageFile;
+  scriptPath;
+  scriptArgs;
+  scriptTimeoutMs;
+  constructor(params) {
+    this.name = params.name;
+    this.description = params.description;
+    this.capabilities = params.capabilities;
+    this.priceSubunits = params.priceSubunits;
+    this.asset = params.asset;
+    this.image = params.image;
+    this.imageFile = params.imageFile;
+    this.scriptPath = params.scriptPath;
+    this.scriptArgs = params.scriptArgs;
+    this.scriptTimeoutMs = params.scriptTimeoutMs;
+  }
+  async execute(_input, ctx) {
+    const result = await runScript(this.scriptPath, this.scriptArgs, {
+      cwd: dirname(this.scriptPath),
+      signal: ctx.signal,
+      timeoutMs: this.scriptTimeoutMs
+    });
+    if (result.spawnError) {
+      throw new Error(`script spawn failed: ${result.spawnError.message}`);
+    }
+    if (result.code !== 0) {
+      const detail = result.stderr.trim() || result.stdout.trim() || "(no output)";
+      throw new Error(`script failed (exit ${result.code}): ${detail}`);
+    }
+    return { data: result.stdout.trim() };
+  }
+};
+var DynamicScriptSkill = class {
+  name;
+  description;
+  capabilities;
+  priceSubunits;
+  asset;
+  mode = "dynamic-script";
+  image;
+  imageFile;
+  scriptPath;
+  scriptArgs;
+  scriptTimeoutMs;
+  constructor(params) {
+    this.name = params.name;
+    this.description = params.description;
+    this.capabilities = params.capabilities;
+    this.priceSubunits = params.priceSubunits;
+    this.asset = params.asset;
+    this.image = params.image;
+    this.imageFile = params.imageFile;
+    this.scriptPath = params.scriptPath;
+    this.scriptArgs = params.scriptArgs;
+    this.scriptTimeoutMs = params.scriptTimeoutMs;
+  }
+  async execute(input, ctx) {
+    const result = await runScript(this.scriptPath, this.scriptArgs, {
+      cwd: dirname(this.scriptPath),
+      stdin: input.data,
+      signal: ctx.signal,
+      timeoutMs: this.scriptTimeoutMs
     });
+    if (result.spawnError) {
+      throw new Error(`script spawn failed: ${result.spawnError.message}`);
+    }
+    if (result.code !== 0) {
+      const detail = result.stderr.trim() || result.stdout.trim() || "(no output)";
+      throw new Error(`script failed (exit ${result.code}): ${detail}`);
+    }
+    return { data: result.stdout.trim() };
   }
 };
+function resolveInsidePath(rootDir, value) {
+  const root = resolve(rootDir);
+  const candidate = resolve(root, value);
+  const rel = relative(root, candidate);
+  if (rel === "" || rel.startsWith("..") || rel.includes(`..${sep}`)) {
+    return null;
+  }
+  return candidate;
+}
 var LAMPORTS_PER_SOL = 1e9;
 var NATIVE_SOL = {
   chain: "solana",
@@ -520,6 +655,12 @@ Decimal.clone({ toExpNeg: -100, toExpPos: 100, precision: 50 });
 
 // src/skills/loader.ts
 var DEFAULT_MAX_TOOL_ROUNDS = 10;
+var VALID_MODES = [
+  "llm",
+  "static-file",
+  "static-script",
+  "dynamic-script"
+];
 function solToLamports(sol) {
   const asNumber = typeof sol === "string" ? Number(sol) : sol;
   if (!Number.isFinite(asNumber) || asNumber < 0) {
@@ -636,6 +777,43 @@ function validateTool(raw, skillName, index) {
     parameters
   };
 }
+function validateMode(skillName, raw) {
+  if (raw === void 0 || raw === null) {
+    return "llm";
+  }
+  if (typeof raw !== "string") {
+    throw new Error(`SKILL.md "${skillName}": "mode" must be a string`);
+  }
+  if (!VALID_MODES.includes(raw)) {
+    throw new Error(
+      `SKILL.md "${skillName}": invalid mode "${raw}". Allowed: ${VALID_MODES.join(", ")}`
+    );
+  }
+  return raw;
+}
+function validateScriptArgs(skillName, raw) {
+  if (raw === void 0 || raw === null) {
+    return [];
+  }
+  if (!Array.isArray(raw)) {
+    throw new Error(`SKILL.md "${skillName}": "script_args" must be an array of strings`);
+  }
+  for (const part of raw) {
+    if (typeof part !== "string") {
+      throw new Error(`SKILL.md "${skillName}": "script_args" entries must be strings`);
+    }
+  }
+  return raw;
+}
+function validateScriptTimeoutMs(skillName, raw) {
+  if (raw === void 0 || raw === null) {
+    return void 0;
+  }
+  if (typeof raw !== "number" || !Number.isInteger(raw) || raw <= 0) {
+    throw new Error(`SKILL.md "${skillName}": "script_timeout_ms" must be a positive integer`);
+  }
+  return raw;
+}
 function validateSkillFrontmatter(frontmatter, systemPrompt, options = {}) {
   if (typeof frontmatter.name !== "string" || frontmatter.name.length === 0) {
     throw new Error('SKILL.md: missing or invalid "name" field');
@@ -687,8 +865,14 @@ function validateSkillFrontmatter(frontmatter, systemPrompt, options = {}) {
       );
     }
   }
+  const mode = validateMode(frontmatter.name, frontmatter.mode);
   const tools = [];
   if (frontmatter.tools !== void 0) {
+    if (mode !== "llm") {
+      throw new Error(
+        `SKILL.md "${frontmatter.name}": "tools" is only valid in mode 'llm' (got '${mode}')`
+      );
+    }
     if (!Array.isArray(frontmatter.tools)) {
       throw new Error(`SKILL.md "${frontmatter.name}": "tools" must be an array`);
     }
@@ -698,6 +882,11 @@ function validateSkillFrontmatter(frontmatter, systemPrompt, options = {}) {
   }
   let maxToolRounds = DEFAULT_MAX_TOOL_ROUNDS;
   if (frontmatter.max_tool_rounds !== void 0) {
+    if (mode !== "llm") {
+      throw new Error(
+        `SKILL.md "${frontmatter.name}": "max_tool_rounds" is only valid in mode 'llm' (got '${mode}')`
+      );
+    }
     if (typeof frontmatter.max_tool_rounds !== "number" || !Number.isInteger(frontmatter.max_tool_rounds) || frontmatter.max_tool_rounds <= 0) {
       throw new Error(
         `SKILL.md "${frontmatter.name}": "max_tool_rounds" must be a positive integer`
@@ -705,6 +894,56 @@ function validateSkillFrontmatter(frontmatter, systemPrompt, options = {}) {
     }
     maxToolRounds = frontmatter.max_tool_rounds;
   }
+  let outputFile;
+  let script;
+  let scriptArgs = [];
+  let scriptTimeoutMs;
+  if (mode === "static-file") {
+    if (typeof frontmatter.output_file !== "string" || frontmatter.output_file.length === 0) {
+      throw new Error(
+        `SKILL.md "${frontmatter.name}": mode 'static-file' requires "output_file" (string)`
+      );
+    }
+    if (frontmatter.script !== void 0) {
+      throw new Error(
+        `SKILL.md "${frontmatter.name}": "script" is not valid in mode 'static-file'`
+      );
+    }
+    outputFile = frontmatter.output_file;
+  } else if (mode === "static-script" || mode === "dynamic-script") {
+    if (typeof frontmatter.script !== "string" || frontmatter.script.length === 0) {
+      throw new Error(`SKILL.md "${frontmatter.name}": mode '${mode}' requires "script" (string)`);
+    }
+    if (frontmatter.output_file !== void 0) {
+      throw new Error(
+        `SKILL.md "${frontmatter.name}": "output_file" is only valid in mode 'static-file'`
+      );
+    }
+    script = frontmatter.script;
+    scriptArgs = validateScriptArgs(frontmatter.name, frontmatter.script_args);
+    scriptTimeoutMs = validateScriptTimeoutMs(frontmatter.name, frontmatter.script_timeout_ms);
+  } else {
+    if (frontmatter.output_file !== void 0) {
+      throw new Error(
+        `SKILL.md "${frontmatter.name}": "output_file" is only valid in mode 'static-file'`
+      );
+    }
+    if (frontmatter.script !== void 0) {
+      throw new Error(
+        `SKILL.md "${frontmatter.name}": "script" is only valid in script modes (static-script, dynamic-script)`
+      );
+    }
+    if (frontmatter.script_args !== void 0) {
+      throw new Error(
+        `SKILL.md "${frontmatter.name}": "script_args" is only valid in script modes`
+      );
+    }
+    if (frontmatter.script_timeout_ms !== void 0) {
+      throw new Error(
+        `SKILL.md "${frontmatter.name}": "script_timeout_ms" is only valid in script modes`
+      );
+    }
+  }
   const image = typeof frontmatter.image === "string" ? frontmatter.image : void 0;
   const imageFile = typeof frontmatter.image_file === "string" ? frontmatter.image_file : void 0;
   return {
@@ -713,13 +952,85 @@ function validateSkillFrontmatter(frontmatter, systemPrompt, options = {}) {
     capabilities,
     priceSubunits,
     asset,
+    mode,
     systemPrompt,
     tools,
     maxToolRounds,
     image,
-    imageFile
+    imageFile,
+    outputFile,
+    script,
+    scriptArgs,
+    scriptTimeoutMs
   };
 }
+function buildSkillFromParsed(parsed, skillDir, logger) {
+  switch (parsed.mode) {
+    case "llm":
+      return new ScriptSkill({
+        name: parsed.name,
+        description: parsed.description,
+        capabilities: parsed.capabilities,
+        priceSubunits: parsed.priceSubunits,
+        asset: parsed.asset,
+        skillDir,
+        systemPrompt: parsed.systemPrompt,
+        tools: parsed.tools,
+        maxToolRounds: parsed.maxToolRounds,
+        image: parsed.image,
+        imageFile: parsed.imageFile,
+        logger
+      });
+    case "static-file": {
+      if (parsed.outputFile === void 0) {
+        throw new Error(
+          `SKILL.md "${parsed.name}": internal error - outputFile missing for mode 'static-file'`
+        );
+      }
+      const outputFilePath = resolveInsidePath(skillDir, parsed.outputFile);
+      if (!outputFilePath) {
+        throw new Error(
+          `SKILL.md "${parsed.name}": "output_file" must stay inside the skill directory`
+        );
+      }
+      return new StaticFileSkill({
+        name: parsed.name,
+        description: parsed.description,
+        capabilities: parsed.capabilities,
+        priceSubunits: parsed.priceSubunits,
+        asset: parsed.asset,
+        outputFilePath,
+        image: parsed.image,
+        imageFile: parsed.imageFile
+      });
+    }
+    case "static-script":
+    case "dynamic-script": {
+      if (parsed.script === void 0) {
+        throw new Error(
+          `SKILL.md "${parsed.name}": internal error - script missing for mode '${parsed.mode}'`
+        );
+      }
+      const scriptPath = resolveInsidePath(skillDir, parsed.script);
+      if (!scriptPath) {
+        throw new Error(`SKILL.md "${parsed.name}": "script" must stay inside the skill directory`);
+      }
+      const Ctor = parsed.mode === "static-script" ? StaticScriptSkill : DynamicScriptSkill;
+      return new Ctor({
+        name: parsed.name,
+        description: parsed.description,
+        capabilities: parsed.capabilities,
+        priceSubunits: parsed.priceSubunits,
+        asset: parsed.asset,
+        scriptPath,
+        scriptArgs: parsed.scriptArgs,
+        scriptTimeoutMs: parsed.scriptTimeoutMs ?? DEFAULT_SCRIPT_TIMEOUT_MS,
+        image: parsed.image,
+        imageFile: parsed.imageFile
+      });
+    }
+  }
+}
 function loadSkillsFromDir(skillsDir, options = {}) {
   const logger = options.logger ?? {};
   const skills = [];
@@ -744,22 +1055,7 @@ function loadSkillsFromDir(skillsDir, options = {}) {
       const content = readFileSync(skillMdPath, "utf-8");
       const { frontmatter, systemPrompt } = parseSkillMd(content);
       const parsed = validateSkillFrontmatter(frontmatter, systemPrompt, options);
-      skills.push(
-        new ScriptSkill({
-          name: parsed.name,
-          description: parsed.description,
-          capabilities: parsed.capabilities,
-          priceSubunits: parsed.priceSubunits,
-          asset: parsed.asset,
-          skillDir: entryPath,
-          systemPrompt: parsed.systemPrompt,
-          tools: parsed.tools,
-          maxToolRounds: parsed.maxToolRounds,
-          image: parsed.image,
-          imageFile: parsed.imageFile,
-          logger
-        })
-      );
+      skills.push(buildSkillFromParsed(parsed, entryPath, logger));
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
       logger.warn?.({ dir: entry, err: message }, "skipping malformed skill directory");
@@ -768,6 +1064,6 @@ function loadSkillsFromDir(skillsDir, options = {}) {
   return skills;
 }
 
-export { DEFAULT_MAX_TOOL_ROUNDS, ScriptSkill, createAnthropicClient, createLlmClient, createOpenAIClient, loadSkillsFromDir, parseSkillMd, validateSkillFrontmatter };
+export { DEFAULT_MAX_TOOL_ROUNDS, DEFAULT_SCRIPT_TIMEOUT_MS, DynamicScriptSkill, MAX_SCRIPT_OUTPUT, MAX_STATIC_FILE_SIZE, ScriptSkill, StaticFileSkill, StaticScriptSkill, createAnthropicClient, createLlmClient, createOpenAIClient, loadSkillsFromDir, parseSkillMd, resolveInsidePath, runScript, validateSkillFrontmatter };
 //# sourceMappingURL=skills.js.map
 //# sourceMappingURL=skills.js.map