@elisym/sdk 0.25.0 → 0.25.3

package/dist/skills.d.cts

@@ -29,9 +29,16 @@ interface SkillOutput {
      */
     filePath?: string;
     /**
-     * Releases the resources backing `filePath` (e.g. a temp dir). The runtime
-     * calls it once it has seeded the file - or failed to - since seeding happens
-     * after `execute()` returns and the producer cannot release the file itself.
+     * Local paths to MULTIPLE file results (a skill that wrote several files to
+     * `ELISYM_OUTPUT_DIR`). When set, each is seeded + delivered as its own
+     * attachment; `outputMime` applies to all. Mutually exclusive with `filePath`
+     * (the runtime prefers `filePaths` when both are somehow present).
+     */
+    filePaths?: string[];
+    /**
+     * Releases the resources backing `filePath`/`filePaths` (e.g. a temp dir). The
+     * runtime calls it once it has seeded the file(s) - or failed to - since seeding
+     * happens after `execute()` returns and the producer cannot release them itself.
      * Mirrors the input-side cleanup callback in the runtime's `resolveInputFile`.
      */
     cleanup?: () => Promise<void>;
@@ -451,6 +458,13 @@ interface SkillFrontmatter {
      * exact. Its presence signals "this capability needs a file input".
      */
     input_mime?: unknown;
+    /**
+     * Whether the skill ALSO accepts a text prompt alongside a file input
+     * (`dynamic-script` only; meaningful only with `input_mime`). `'none'` = file
+     * only, `'optional'` = file + optional note (default), `'required'` = needs both.
+     * Discovery hint only; lets the web app show/hide its text box for file jobs.
+     */
+    input_text?: unknown;
     /**
      * Optional per-skill rate limit. Applies to any skill mode. Snake-case
      * keys here match the YAML frontmatter convention; parsed into camelCase
@@ -503,6 +517,12 @@ interface ParsedSkill {
      * capability needs a file input (clients gate file-only flows on it).
      */
     inputMime?: string;
+    /**
+     * Whether the skill also accepts a text prompt with a file input (mode
+     * 'dynamic-script' only). Discovery hint; clients (the web app) gate their text
+     * box on it. Default behavior when absent = file + optional text.
+     */
+    inputText?: 'required' | 'optional' | 'none';
     /** Optional per-skill rate limit (any mode). */
     rateLimit?: SkillRateLimit;
     /**

package/dist/skills.d.ts

@@ -29,9 +29,16 @@ interface SkillOutput {
      */
     filePath?: string;
     /**
-     * Releases the resources backing `filePath` (e.g. a temp dir). The runtime
-     * calls it once it has seeded the file - or failed to - since seeding happens
-     * after `execute()` returns and the producer cannot release the file itself.
+     * Local paths to MULTIPLE file results (a skill that wrote several files to
+     * `ELISYM_OUTPUT_DIR`). When set, each is seeded + delivered as its own
+     * attachment; `outputMime` applies to all. Mutually exclusive with `filePath`
+     * (the runtime prefers `filePaths` when both are somehow present).
+     */
+    filePaths?: string[];
+    /**
+     * Releases the resources backing `filePath`/`filePaths` (e.g. a temp dir). The
+     * runtime calls it once it has seeded the file(s) - or failed to - since seeding
+     * happens after `execute()` returns and the producer cannot release them itself.
      * Mirrors the input-side cleanup callback in the runtime's `resolveInputFile`.
      */
     cleanup?: () => Promise<void>;
@@ -451,6 +458,13 @@ interface SkillFrontmatter {
      * exact. Its presence signals "this capability needs a file input".
      */
     input_mime?: unknown;
+    /**
+     * Whether the skill ALSO accepts a text prompt alongside a file input
+     * (`dynamic-script` only; meaningful only with `input_mime`). `'none'` = file
+     * only, `'optional'` = file + optional note (default), `'required'` = needs both.
+     * Discovery hint only; lets the web app show/hide its text box for file jobs.
+     */
+    input_text?: unknown;
     /**
      * Optional per-skill rate limit. Applies to any skill mode. Snake-case
      * keys here match the YAML frontmatter convention; parsed into camelCase
@@ -503,6 +517,12 @@ interface ParsedSkill {
      * capability needs a file input (clients gate file-only flows on it).
      */
     inputMime?: string;
+    /**
+     * Whether the skill also accepts a text prompt with a file input (mode
+     * 'dynamic-script' only). Discovery hint; clients (the web app) gate their text
+     * box on it. Default behavior when absent = file + optional text.
+     */
+    inputText?: 'required' | 'optional' | 'none';
     /** Optional per-skill rate limit (any mode). */
     rateLimit?: SkillRateLimit;
     /**

package/dist/skills.js

@@ -1,6 +1,6 @@
 import { spawn } from 'node:child_process';
 import { StringDecoder } from 'node:string_decoder';
-import { readFile, mkdtemp, stat, rm } from 'node:fs/promises';
+import { readFile, mkdtemp, mkdir, readdir, stat, rm } from 'node:fs/promises';
 import { dirname, join, resolve, relative, sep } from 'node:path';
 import { tmpdir } from 'node:os';
 import { readdirSync, statSync, readFileSync } from 'node:fs';
@@ -365,9 +365,12 @@ var DynamicScriptSkill = class {
   async execute(input, ctx) {
     const outDir = await mkdtemp(join(tmpdir(), "elisym-skill-out-"));
     const outputFile = join(outDir, "output");
+    const outputDir = join(outDir, "files");
+    await mkdir(outputDir, { recursive: true });
     const env = {
       ...this.scriptEnv ?? process.env,
-      ELISYM_OUTPUT_FILE: outputFile
+      ELISYM_OUTPUT_FILE: outputFile,
+      ELISYM_OUTPUT_DIR: outputDir
     };
     if (input.filePath !== void 0) {
       env.ELISYM_INPUT_FILE = input.filePath;
@@ -395,6 +398,29 @@ var DynamicScriptSkill = class {
         const detail = result.stderr.trim() || result.stdout.trim() || "(no output)";
         throw new ScriptExecutionError(result.code, detail);
       }
+      const dirEntries = await readdir(outputDir, { withFileTypes: true }).catch(() => []);
+      const filePaths = [];
+      for (const entry of dirEntries.sort((a, b) => a.name.localeCompare(b.name))) {
+        if (!entry.isFile()) {
+          continue;
+        }
+        const candidate = join(outputDir, entry.name);
+        const entryStat = await stat(candidate).catch(() => null);
+        if (entryStat !== null && entryStat.isFile() && entryStat.size > 0) {
+          filePaths.push(candidate);
+        }
+      }
+      if (filePaths.length > 0) {
+        keepOutDir = true;
+        return {
+          data: result.stdout.trim(),
+          filePaths,
+          outputMime: this.outputMime ?? "application/octet-stream",
+          cleanup: async () => {
+            await rm(outDir, { recursive: true, force: true });
+          }
+        };
+      }
       const outputStat = await stat(outputFile).catch(() => null);
       if (outputStat !== null && outputStat.isFile() && outputStat.size > 0) {
         keepOutDir = true;
@@ -762,6 +788,18 @@ function validateInputMime(skillName, raw) {
   }
   return raw;
 }
+var INPUT_TEXT_VALUES = ["required", "optional", "none"];
+function validateInputText(skillName, raw) {
+  if (raw === void 0 || raw === null) {
+    return void 0;
+  }
+  if (typeof raw !== "string" || !INPUT_TEXT_VALUES.includes(raw)) {
+    throw new Error(
+      `SKILL.md "${skillName}": "input_text" must be one of "required", "optional", "none"`
+    );
+  }
+  return raw;
+}
 function validateMaxExecutionSecs(skillName, raw) {
   if (raw === void 0 || raw === null) {
     return void 0;
@@ -864,6 +902,7 @@ function validateSkillFrontmatter(frontmatter, systemPrompt, options = {}) {
   let scriptTimeoutMs;
   let outputMime;
   let inputMime;
+  let inputText;
   if (mode === "static-file") {
     if (typeof frontmatter.output_file !== "string" || frontmatter.output_file.length === 0) {
       throw new Error(
@@ -885,6 +924,11 @@ function validateSkillFrontmatter(frontmatter, systemPrompt, options = {}) {
         `SKILL.md "${frontmatter.name}": "input_mime" is only valid in mode 'dynamic-script'`
       );
     }
+    if (frontmatter.input_text !== void 0) {
+      throw new Error(
+        `SKILL.md "${frontmatter.name}": "input_text" is only valid in mode 'dynamic-script'`
+      );
+    }
     outputFile = frontmatter.output_file;
   } else if (mode === "static-script" || mode === "dynamic-script") {
     if (typeof frontmatter.script !== "string" || frontmatter.script.length === 0) {
@@ -901,6 +945,7 @@ function validateSkillFrontmatter(frontmatter, systemPrompt, options = {}) {
     if (mode === "dynamic-script") {
       outputMime = validateOutputMime(frontmatter.name, frontmatter.output_mime);
       inputMime = validateInputMime(frontmatter.name, frontmatter.input_mime);
+      inputText = validateInputText(frontmatter.name, frontmatter.input_text);
     } else {
       if (frontmatter.output_mime !== void 0) {
         throw new Error(
@@ -912,6 +957,11 @@ function validateSkillFrontmatter(frontmatter, systemPrompt, options = {}) {
           `SKILL.md "${frontmatter.name}": "input_mime" is only valid in mode 'dynamic-script'`
         );
       }
+      if (frontmatter.input_text !== void 0) {
+        throw new Error(
+          `SKILL.md "${frontmatter.name}": "input_text" is only valid in mode 'dynamic-script'`
+        );
+      }
     }
   } else {
     if (frontmatter.output_file !== void 0) {
@@ -944,6 +994,11 @@ function validateSkillFrontmatter(frontmatter, systemPrompt, options = {}) {
         `SKILL.md "${frontmatter.name}": "input_mime" is only valid in mode 'dynamic-script'`
       );
     }
+    if (frontmatter.input_text !== void 0) {
+      throw new Error(
+        `SKILL.md "${frontmatter.name}": "input_text" is only valid in mode 'dynamic-script'`
+      );
+    }
   }
   const image = typeof frontmatter.image === "string" ? frontmatter.image : void 0;
   const imageFile = typeof frontmatter.image_file === "string" ? frontmatter.image_file : void 0;
@@ -972,6 +1027,7 @@ function validateSkillFrontmatter(frontmatter, systemPrompt, options = {}) {
     scriptTimeoutMs,
     outputMime,
     inputMime,
+    inputText,
     rateLimit,
     executionTimeoutSecs
   };