@elisym/sdk 0.13.0 → 0.15.0

package/dist/skills.js

@@ -6,303 +6,7 @@ import { readdirSync, statSync, readFileSync } from 'node:fs';
 import YAML from 'yaml';
 import Decimal from 'decimal.js-light';
 
-// src/skills/llmClient.ts
-var LLM_TIMEOUT_MS = 12e4;
-var MAX_RETRIES = 2;
-var RETRYABLE_STATUSES = /* @__PURE__ */ new Set([429, 500, 502, 503, 504]);
-var DEFAULT_MAX_TOKENS = 4096;
-var DEFAULT_ANTHROPIC_MODEL = "claude-haiku-4-5-20251001";
-var DEFAULT_OPENAI_MODEL = "gpt-4o-mini";
-function createAbortError() {
-  const err = new Error("The operation was aborted");
-  err.name = "AbortError";
-  return err;
-}
-function sleepWithSignal(ms, signal) {
-  if (signal?.aborted) {
-    return Promise.reject(createAbortError());
-  }
-  if (!signal) {
-    return new Promise((resolve2) => setTimeout(resolve2, ms));
-  }
-  return new Promise((resolve2, reject) => {
-    const cleanup = () => {
-      clearTimeout(timer);
-      signal.removeEventListener("abort", onAbort);
-    };
-    const onAbort = () => {
-      cleanup();
-      reject(createAbortError());
-    };
-    const timer = setTimeout(() => {
-      cleanup();
-      resolve2();
-    }, ms);
-    signal.addEventListener("abort", onAbort, { once: true });
-  });
-}
-async function fetchWithTimeout(url, init, signal) {
-  if (signal?.aborted) {
-    throw createAbortError();
-  }
-  const controller = new AbortController();
-  const timer = setTimeout(() => controller.abort(), LLM_TIMEOUT_MS);
-  const onAbort = () => controller.abort();
-  signal?.addEventListener("abort", onAbort, { once: true });
-  try {
-    return await fetch(url, { ...init, signal: controller.signal });
-  } finally {
-    clearTimeout(timer);
-    signal?.removeEventListener("abort", onAbort);
-  }
-}
-async function fetchWithRetry(url, init, signal) {
-  for (let attempt = 0; ; attempt++) {
-    let response;
-    try {
-      response = await fetchWithTimeout(url, init, signal);
-    } catch (error) {
-      const name = error instanceof Error ? error.name : "";
-      if (attempt >= MAX_RETRIES || name === "AbortError") {
-        throw error;
-      }
-      await sleepWithSignal(Math.min(1e3 * 2 ** attempt, 8e3), signal);
-      continue;
-    }
-    if (response.ok || attempt >= MAX_RETRIES || !RETRYABLE_STATUSES.has(response.status)) {
-      return response;
-    }
-    const retryAfter = response.headers.get("retry-after");
-    const delay = retryAfter ? Math.min(parseInt(retryAfter, 10) * 1e3 || 1e3 * 2 ** attempt, 3e4) : Math.min(1e3 * 2 ** attempt, 8e3);
-    await response.body?.cancel().catch(() => void 0);
-    await sleepWithSignal(delay, signal);
-  }
-}
-var AnthropicClient = class {
-  constructor(config) {
-    this.config = config;
-  }
-  async complete(systemPrompt, userInput, signal) {
-    const response = await fetchWithRetry(
-      "https://api.anthropic.com/v1/messages",
-      {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          "x-api-key": this.config.apiKey,
-          "anthropic-version": "2023-06-01"
-        },
-        body: JSON.stringify({
-          model: this.config.model,
-          max_tokens: this.config.maxTokens,
-          system: systemPrompt,
-          messages: [{ role: "user", content: userInput }]
-        })
-      },
-      signal
-    );
-    if (!response.ok) {
-      throw new Error(`Anthropic API error: ${response.status} ${await response.text()}`);
-    }
-    const data = await response.json();
-    const textBlock = data.content?.find((block) => block.type === "text");
-    return textBlock?.text ?? "";
-  }
-  async completeWithTools(systemPrompt, messages, tools, signal) {
-    const anthropicTools = tools.map((tool) => ({
-      name: tool.name,
-      description: tool.description,
-      input_schema: {
-        type: "object",
-        properties: Object.fromEntries(
-          tool.parameters.map((param) => [
-            param.name,
-            { type: "string", description: param.description }
-          ])
-        ),
-        required: tool.parameters.filter((param) => param.required).map((param) => param.name)
-      }
-    }));
-    const response = await fetchWithRetry(
-      "https://api.anthropic.com/v1/messages",
-      {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          "x-api-key": this.config.apiKey,
-          "anthropic-version": "2023-06-01"
-        },
-        body: JSON.stringify({
-          model: this.config.model,
-          max_tokens: this.config.maxTokens,
-          system: systemPrompt,
-          messages,
-          tools: anthropicTools
-        })
-      },
-      signal
-    );
-    if (!response.ok) {
-      throw new Error(`Anthropic API error: ${response.status} ${await response.text()}`);
-    }
-    const data = await response.json();
-    const content = data.content ?? [];
-    const toolUses = content.filter((block) => block.type === "tool_use");
-    if (toolUses.length > 0) {
-      const calls = toolUses.map((block) => ({
-        id: block.id ?? "",
-        name: block.name ?? "",
-        arguments: block.input ?? {}
-      }));
-      return {
-        type: "tool_use",
-        calls,
-        assistantMessage: { role: "assistant", content }
-      };
-    }
-    const textBlock = content.find((block) => block.type === "text");
-    return { type: "text", text: textBlock?.text ?? "" };
-  }
-  formatToolResultMessages(results) {
-    return [
-      {
-        role: "user",
-        content: results.map((result) => ({
-          type: "tool_result",
-          tool_use_id: result.callId,
-          content: result.content
-        }))
-      }
-    ];
-  }
-};
-var OpenAIClient = class {
-  constructor(config) {
-    this.config = config;
-  }
-  isReasoningModel() {
-    return /^o\d/.test(this.config.model);
-  }
-  async complete(systemPrompt, userInput, signal) {
-    const reasoning = this.isReasoningModel();
-    const response = await fetchWithRetry(
-      "https://api.openai.com/v1/chat/completions",
-      {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          Authorization: `Bearer ${this.config.apiKey}`
-        },
-        body: JSON.stringify({
-          model: this.config.model,
-          ...reasoning ? { max_completion_tokens: this.config.maxTokens } : { max_tokens: this.config.maxTokens },
-          messages: [
-            { role: reasoning ? "developer" : "system", content: systemPrompt },
-            { role: "user", content: userInput }
-          ]
-        })
-      },
-      signal
-    );
-    if (!response.ok) {
-      throw new Error(`OpenAI API error: ${response.status} ${await response.text()}`);
-    }
-    const data = await response.json();
-    return data.choices?.[0]?.message?.content ?? "";
-  }
-  async completeWithTools(systemPrompt, messages, tools, signal) {
-    const openaiTools = tools.map((tool) => ({
-      type: "function",
-      function: {
-        name: tool.name,
-        description: tool.description,
-        parameters: {
-          type: "object",
-          properties: Object.fromEntries(
-            tool.parameters.map((param) => [
-              param.name,
-              { type: "string", description: param.description }
-            ])
-          ),
-          required: tool.parameters.filter((param) => param.required).map((param) => param.name)
-        }
-      }
-    }));
-    const reasoning = this.isReasoningModel();
-    const response = await fetchWithRetry(
-      "https://api.openai.com/v1/chat/completions",
-      {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          Authorization: `Bearer ${this.config.apiKey}`
-        },
-        body: JSON.stringify({
-          model: this.config.model,
-          ...reasoning ? { max_completion_tokens: this.config.maxTokens } : { max_tokens: this.config.maxTokens },
-          messages: [
-            { role: reasoning ? "developer" : "system", content: systemPrompt },
-            ...messages
-          ],
-          tools: openaiTools
-        })
-      },
-      signal
-    );
-    if (!response.ok) {
-      throw new Error(`OpenAI API error: ${response.status} ${await response.text()}`);
-    }
-    const data = await response.json();
-    const message = data.choices?.[0]?.message;
-    const toolCalls = message?.tool_calls ?? [];
-    if (toolCalls.length > 0) {
-      const calls = toolCalls.map((call) => {
-        let args;
-        try {
-          args = JSON.parse(call.function?.arguments ?? "{}");
-        } catch {
-          args = {};
-        }
-        return { id: call.id ?? "", name: call.function?.name ?? "", arguments: args };
-      });
-      return { type: "tool_use", calls, assistantMessage: message };
-    }
-    return { type: "text", text: message?.content ?? "" };
-  }
-  formatToolResultMessages(results) {
-    return results.map((result) => ({
-      role: "tool",
-      tool_call_id: result.callId,
-      content: result.content
-    }));
-  }
-};
-function createAnthropicClient(config) {
-  if (!config.apiKey) {
-    throw new Error("ANTHROPIC_API_KEY is required for skill runtime");
-  }
-  return new AnthropicClient({
-    apiKey: config.apiKey,
-    model: config.model ?? DEFAULT_ANTHROPIC_MODEL,
-    maxTokens: config.maxTokens ?? DEFAULT_MAX_TOKENS
-  });
-}
-function createOpenAIClient(config) {
-  if (!config.apiKey) {
-    throw new Error("OPENAI_API_KEY is required for skill runtime");
-  }
-  return new OpenAIClient({
-    apiKey: config.apiKey,
-    model: config.model ?? DEFAULT_OPENAI_MODEL,
-    maxTokens: config.maxTokens ?? DEFAULT_MAX_TOKENS
-  });
-}
-function createLlmClient(config) {
-  if (config.provider === "openai") {
-    return createOpenAIClient(config);
-  }
-  return createAnthropicClient(config);
-}
+// src/skills/scriptSkill.ts
 var MAX_SCRIPT_OUTPUT = 1e6;
 var DEFAULT_SCRIPT_TIMEOUT_MS = 6e4;
 function runScript(cmd, args, opts) {
@@ -681,7 +385,6 @@ function parseAssetAmount(asset, human) {
 Decimal.clone({ toExpNeg: -100, toExpPos: 100, precision: 50 });
 
 // src/skills/loader.ts
-var VALID_PROVIDERS = ["anthropic", "openai"];
 var MAX_TOKENS_LIMIT = 2e5;
 var DEFAULT_MAX_TOOL_ROUNDS = 10;
 var VALID_MODES = [
@@ -853,13 +556,8 @@ function validateLlmOverride(skillName, frontmatter, mode) {
   }
   const override = {};
   if (hasProvider && hasModel) {
-    if (typeof frontmatter.provider !== "string") {
-      throw new Error(`SKILL.md "${skillName}": "provider" must be a string`);
-    }
-    if (!VALID_PROVIDERS.includes(frontmatter.provider)) {
-      throw new Error(
-        `SKILL.md "${skillName}": invalid provider "${frontmatter.provider}". Allowed: ${VALID_PROVIDERS.join(", ")}`
-      );
+    if (typeof frontmatter.provider !== "string" || frontmatter.provider.length === 0) {
+      throw new Error(`SKILL.md "${skillName}": "provider" must be a non-empty string`);
     }
     if (typeof frontmatter.model !== "string" || frontmatter.model.length === 0) {
       throw new Error(`SKILL.md "${skillName}": "model" must be a non-empty string`);
@@ -877,6 +575,33 @@ function validateLlmOverride(skillName, frontmatter, mode) {
   }
   return override;
 }
+var MAX_RATE_LIMIT_WINDOW_SECS = 86400;
+var MAX_RATE_LIMIT_PER_WINDOW = 1e4;
+function validateRateLimit(skillName, raw) {
+  if (raw === void 0 || raw === null) {
+    return void 0;
+  }
+  if (typeof raw !== "object") {
+    throw new Error(`SKILL.md "${skillName}": "rate_limit" must be an object`);
+  }
+  const record = raw;
+  const perWindowSecs = record.per_window_secs;
+  const maxPerWindow = record.max_per_window;
+  if (typeof perWindowSecs !== "number" || !Number.isInteger(perWindowSecs) || perWindowSecs < 1 || perWindowSecs > MAX_RATE_LIMIT_WINDOW_SECS) {
+    throw new Error(
+      `SKILL.md "${skillName}": "rate_limit.per_window_secs" must be an integer between 1 and ${MAX_RATE_LIMIT_WINDOW_SECS}`
+    );
+  }
+  if (typeof maxPerWindow !== "number" || !Number.isInteger(maxPerWindow) || maxPerWindow < 1 || maxPerWindow > MAX_RATE_LIMIT_PER_WINDOW) {
+    throw new Error(
+      `SKILL.md "${skillName}": "rate_limit.max_per_window" must be an integer between 1 and ${MAX_RATE_LIMIT_PER_WINDOW}`
+    );
+  }
+  return {
+    perWindowMs: perWindowSecs * 1e3,
+    maxPerWindow
+  };
+}
 function validateScriptTimeoutMs(skillName, raw) {
   if (raw === void 0 || raw === null) {
     return void 0;
@@ -1019,6 +744,7 @@ function validateSkillFrontmatter(frontmatter, systemPrompt, options = {}) {
   const image = typeof frontmatter.image === "string" ? frontmatter.image : void 0;
   const imageFile = typeof frontmatter.image_file === "string" ? frontmatter.image_file : void 0;
   const llmOverride = validateLlmOverride(frontmatter.name, frontmatter, mode);
+  const rateLimit = validateRateLimit(frontmatter.name, frontmatter.rate_limit);
   return {
     name: frontmatter.name,
     description: frontmatter.description,
@@ -1035,7 +761,8 @@ function validateSkillFrontmatter(frontmatter, systemPrompt, options = {}) {
     outputFile,
     script,
     scriptArgs,
-    scriptTimeoutMs
+    scriptTimeoutMs,
+    rateLimit
   };
 }
 function buildSkillFromParsed(parsed, skillDir, logger) {
@@ -1139,6 +866,6 @@ function loadSkillsFromDir(skillsDir, options = {}) {
   return skills;
 }
 
-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 };
+export { DEFAULT_MAX_TOOL_ROUNDS, DEFAULT_SCRIPT_TIMEOUT_MS, DynamicScriptSkill, MAX_SCRIPT_OUTPUT, MAX_STATIC_FILE_SIZE, ScriptSkill, StaticFileSkill, StaticScriptSkill, loadSkillsFromDir, parseSkillMd, resolveInsidePath, runScript, validateSkillFrontmatter };
 //# sourceMappingURL=skills.js.map
 //# sourceMappingURL=skills.js.map