lua-cli 3.21.0 → 3.22.0

package/dist/api-exports.d.ts

@@ -2717,12 +2717,30 @@ export declare interface LuaRuntime {
  * // Or add tools after construction
  * skill.addTool(anotherTool);
  * ```
+ *
+ * @example
+ * ```typescript
+ * // Skill with condition - the whole skill is hidden from non-premium users
+ * class PremiumSkill extends LuaSkill {
+ *   name = "premium-skill";
+ *   description = "Advanced tools for premium users";
+ *   context = "Use these tools for premium workflows.";
+ *   tools = [premiumSearchTool];
+ *
+ *   // Condition runs before the skill's tools and context reach the LLM
+ *   condition = async () => {
+ *     const user = await User.get();
+ *     return user.data?.isPremium === true;
+ *   };
+ * }
+ * ```
  */
 export declare class LuaSkill {
     private readonly tools;
     private readonly name;
     private readonly description;
     private readonly context;
+    private readonly condition?;
     /**
      * Creates a new LuaSkill instance.
      *
@@ -2731,9 +2749,11 @@ export declare class LuaSkill {
      * @param config.description - Short description of what the skill does (1-2 sentences)
      * @param config.context - Detailed explanation of how the agent should use the tools
      * @param config.tools - Optional array of tools to add immediately
+     * @param config.condition - Optional async gate; false hides the skill's tools and context
      */
     constructor(config: LuaSkillConfig);
     getContext(): SkillContextText;
+    getCondition(): (() => Promise<boolean>) | undefined;
     /**
      * Adds a single tool to the skill.
      * Tool name is validated before being added.
@@ -2775,6 +2795,12 @@ declare interface LuaSkillConfig {
     context: SkillContextText;
     /** Optional array of tools to add during construction */
     tools?: LuaTool<any>[];
+    /**
+     * Optional async function that determines if the whole skill should be
+     * available. When it returns false the skill's tools are hidden AND the
+     * skill's context is left out of the agent prompt.
+     */
+    condition?: () => Promise<boolean>;
 }
 
 export declare interface LuaTool<TInput extends ZodType = ZodType> {
@@ -5038,6 +5064,9 @@ export declare interface SendTemplateValues {
         image_url?: string;
         video_url?: string;
         document_url?: string;
+        image_id?: string;
+        video_id?: string;
+        document_id?: string;
         document_filename?: string;
     };
     body?: Record<string, string>;

package/dist/api-exports.js

@@ -2233,6 +2233,18 @@ var init_skill_handler = __esm({
           return toolData;
         }).filter(Boolean);
         const sourceArchive = buildSourceArchive(archiveEntries);
+        let condition;
+        let conditionS3Hash;
+        if (skill.hasCondition) {
+          const skillCode = loadArtifact(skill, projectPath);
+          if (bundleAccumulator) {
+            const rawGzip = compressForPushRaw(skillCode);
+            conditionS3Hash = hashBundle(rawGzip);
+            bundleAccumulator.set(conditionS3Hash, rawGzip);
+          } else {
+            condition = compressForPush(skillCode);
+          }
+        }
         return {
           name: skill.name,
           description: skill.description,
@@ -2241,6 +2253,12 @@ var init_skill_handler = __esm({
             context: skill.context
           } : {},
           tools,
+          ...condition ? {
+            condition
+          } : {},
+          ...conditionS3Hash ? {
+            conditionS3Hash
+          } : {},
           ...sourceArchive ? {
             sourceArchive,
             archiveSchemaVersion: SOURCE_ARCHIVE_SCHEMA_VERSION
@@ -5945,6 +5963,7 @@ var LuaSkill = class {
   name;
   description;
   context;
+  condition;
   /**
   * Creates a new LuaSkill instance.
   *
@@ -5953,6 +5972,7 @@ var LuaSkill = class {
   * @param config.description - Short description of what the skill does (1-2 sentences)
   * @param config.context - Detailed explanation of how the agent should use the tools
   * @param config.tools - Optional array of tools to add immediately
+  * @param config.condition - Optional async gate; false hides the skill's tools and context
   */
   constructor(config) {
     if (!config.name || !config.name.trim()) {
@@ -5961,6 +5981,7 @@ var LuaSkill = class {
     this.name = config.name;
     this.description = config.description;
     this.context = config.context;
+    this.condition = config.condition;
     if (typeof this.context === "object") {
       if (!this.context.base && !this.context.voice && !this.context.text) {
         throw new Error("Skill context object must have at least one of: base, voice, text");
@@ -5973,6 +5994,9 @@ var LuaSkill = class {
   getContext() {
     return this.context;
   }
+  getCondition() {
+    return this.condition;
+  }
   /**
   * Adds a single tool to the skill.
   * Tool name is validated before being added.