@vertesia/build-tools 1.0.0-dev.20260128.144200 → 1.0.0-dev.20260225.024852Z

package/README.md

@@ -136,9 +136,48 @@ This is the skill content in markdown.
   related_tools?: string[];        // Optional: Related tool names
   scripts?: string[];              // Optional: Script files in skill dir
   widgets?: string[];              // Optional: Widget names in skill dir
+  isEnabled?: (context: any) => Promise<boolean>;  // Optional: Runtime filter function
 }
 ```
 
+### Runtime Properties (`properties.ts`)
+
+For properties that cannot be defined in YAML frontmatter (like functions), create a `properties.ts` file in your skill directory:
+
+```typescript
+// my-skill/properties.ts
+import type { ToolUseContext } from '@vertesia/tools-sdk';
+
+export default {
+  // Function to check if skill is enabled
+  isEnabled: async (context: ToolUseContext): Promise<boolean> => {
+    return context.project?.settings?.myFeature === true;
+  },
+
+  // You can override any frontmatter property
+  description: 'Dynamically set description',
+
+  // Add any other SkillDefinition properties
+};
+```
+
+**How it works:**
+1. The `properties.ts` file must export a default object of type `Partial<SkillDefinition>`
+2. Properties from `properties.ts` **override** those from frontmatter
+3. During build, the SKILL.md transformer generates code that imports `./properties.js`
+4. Rollup automatically transpiles `properties.ts` to `properties.js` (via TypeScript plugin)
+5. Runtime validation ensures `isEnabled` (if present) is a function
+6. Build fails with clear errors if validation fails
+
+**Directory structure:**
+```
+my-skill/
+  ├── SKILL.md         # Declarative properties (frontmatter + markdown)
+  ├── properties.ts    # Runtime properties (functions, overrides)
+  ├── helper.js        # Script files (auto-discovered)
+  └── chart.tsx        # Widget files (auto-discovered)
+```
+
 ### Raw Transformer
 
 Imports any file as a raw string.

package/lib/build-tools.js

@@ -455,6 +455,9 @@ const SkillFrontmatterSchema = z.object({
  * Zod schema for skill definition
  * This validates the structure of skill objects generated from markdown
  * Matches the SkillDefinition interface from @vertesia/tools-sdk
+ *
+ * Note: The isEnabled property is not included in this schema because Zod cannot
+ * properly validate function signatures. It will be type-checked by TypeScript instead.
  */
 const SkillDefinitionSchema = z.object({
     name: z.string().min(1, 'Skill name is required'),
@@ -472,7 +475,16 @@ const SkillDefinitionSchema = z.object({
     related_tools: z.array(z.string()).optional(),
     scripts: z.array(z.string()).optional(),
     widgets: z.array(z.string()).optional()
-});
+}).passthrough();
+/**
+ * Schema for validating properties exported from properties.ts
+ * This is a partial schema - allows any subset of SkillDefinition fields
+ *
+ * Note: Function properties like isEnabled cannot be validated by Zod for their signatures.
+ * Zod will only check that they are functions, not their specific parameter/return types.
+ * Use TypeScript for proper type checking of function signatures.
+ */
+const SkillPropertiesSchema = SkillDefinitionSchema.partial().passthrough();
 /**
  * Build a SkillDefinition from frontmatter and markdown content.
  * This mirrors the logic in @vertesia/tools-sdk parseSkillFile function.
@@ -562,6 +574,11 @@ function buildSkillDefinition(frontmatter, instructions, contentType, widgets, s
  * - Files with ?skill suffix: ./my-skill.md?skill
  * - SKILL.md files: ./my-skill/SKILL.md
  *
+ * Runtime Properties:
+ * - Supports properties.ts file in skill directory for runtime properties (functions, overrides)
+ * - Properties from properties.ts override those from frontmatter
+ * - See README.md for detailed usage examples
+ *
  * @example
  * ```typescript
  * import skill1 from './my-skill.md?skill';
@@ -579,8 +596,8 @@ const skillTransformer = {
         if (!frontmatterValidation.success) {
             const errors = frontmatterValidation.error.errors
                 .map((err) => {
-                const path = err.path.length > 0 ? err.path.join('.') : 'frontmatter';
-                return `  - ${path}: ${err.message}`;
+                const pathStr = err.path.length > 0 ? err.path.join('.') : 'frontmatter';
+                return `  - ${pathStr}: ${err.message}`;
             })
                 .join('\n');
             throw new Error(`Invalid frontmatter in ${filePath}:\n${errors}`);
@@ -591,6 +608,32 @@ const skillTransformer = {
         const assets = discoverSkillAssets(filePath);
         // Build skill definition using the same logic as parseSkillFile in tools-sdk
         const skillData = buildSkillDefinition(frontmatter, markdown, content_type, assets.widgets, assets.scripts);
+        // Check if properties.ts exists in the skill directory
+        const skillDir = path.dirname(filePath);
+        const propertiesPath = path.join(skillDir, 'properties.ts');
+        const hasProperties = existsSync(propertiesPath);
+        // If properties.ts exists, generate custom code with import and merge
+        // Rollup will handle transpiling properties.ts to properties.js
+        if (hasProperties) {
+            const skillDataJson = JSON.stringify(skillData, null, 2);
+            const code = `import properties from './properties.js';
+
+// Runtime validation for function properties
+if ('isEnabled' in properties && typeof properties.isEnabled !== 'function') {
+  throw new Error('properties.isEnabled must be a function, got ' + typeof properties.isEnabled);
+}
+
+const skill = ${skillDataJson};
+
+export default { ...skill, ...properties };
+`;
+            return {
+                data: skillData,
+                assets: assets.assetFiles,
+                widgets: assets.widgetMetadata,
+                code
+            };
+        }
         return {
             data: skillData,
             assets: assets.assetFiles,
@@ -760,6 +803,7 @@ var PrincipalType;
     PrincipalType["ApiKey"] = "apikey";
     PrincipalType["ServiceAccount"] = "service_account";
     PrincipalType["Agent"] = "agent";
+    PrincipalType["Schedule"] = "schedule";
 })(PrincipalType || (PrincipalType = {}));
 
 var InteractionStatus;
@@ -1165,6 +1209,8 @@ var SupportedIntegrations;
     SupportedIntegrations["aws"] = "aws";
     SupportedIntegrations["magic_pdf"] = "magic_pdf";
     SupportedIntegrations["serper"] = "serper";
+    SupportedIntegrations["exa"] = "exa";
+    SupportedIntegrations["linkup"] = "linkup";
     SupportedIntegrations["resend"] = "resend";
     SupportedIntegrations["ask_user_webhook"] = "ask_user_webhook";
 })(SupportedIntegrations || (SupportedIntegrations = {}));
@@ -1354,8 +1400,8 @@ var MarkdownRenditionFormat;
     'application/pdf': [ImageRenditionFormat.jpeg, ImageRenditionFormat.png, ImageRenditionFormat.webp],
     // Markdown can generate: pdf, docx (NOT jpeg/png)
     'text/markdown': [MarkdownRenditionFormat.pdf, MarkdownRenditionFormat.docx],
-    // Plain text can generate: docx
-    'text/plain': [MarkdownRenditionFormat.docx],
+    // Any text/* can generate: docx (editable export)
+    'text/*': [MarkdownRenditionFormat.docx],
     // Office documents can generate: pdf
     'application/vnd.openxmlformats-officedocument.wordprocessingml.document': [MarkdownRenditionFormat.pdf],
     'application/msword': [MarkdownRenditionFormat.pdf],
@@ -1398,6 +1444,7 @@ var TaskType;
     TaskType["ACTIVITY"] = "activity";
     TaskType["CHILD_WORKFLOW"] = "childWorkflow";
     TaskType["SIGNAL"] = "signal";
+    TaskType["TIMER"] = "timer";
 })(TaskType || (TaskType = {}));
 var WorkflowExecutionStatus;
 (function (WorkflowExecutionStatus) {
@@ -1523,6 +1570,7 @@ var AccountType;
 var ApiVersions;
 (function (ApiVersions) {
     ApiVersions[ApiVersions["COMPLETION_RESULT_V1"] = 20250925] = "COMPLETION_RESULT_V1";
+    ApiVersions[ApiVersions["DOWNLOAD_URL_NO_MIME_TYPE_V1"] = 20260210] = "DOWNLOAD_URL_NO_MIME_TYPE_V1";
 })(ApiVersions || (ApiVersions = {}));
 
 /**
@@ -1746,5 +1794,5 @@ const promptTransformer = {
     }
 };
 
-export { PromptDefinitionSchema, PromptRole, SkillDefinitionSchema, TemplateType, parseFrontmatter, promptTransformer, rawTransformer, skillCollectionTransformer, skillTransformer, vertesiaImportPlugin };
+export { PromptDefinitionSchema, PromptRole, SkillDefinitionSchema, SkillPropertiesSchema, TemplateType, parseFrontmatter, promptTransformer, rawTransformer, skillCollectionTransformer, skillTransformer, vertesiaImportPlugin };
 //# sourceMappingURL=build-tools.js.map