@wix/evalforge-types 0.25.0 → 0.26.0

package/build/types/target/skill.d.ts

@@ -5,6 +5,23 @@ import { z } from 'zod';
  * Examples: my-skill, code-review, skill1
  */
 export declare const SKILL_FOLDER_NAME_REGEX: RegExp;
+/**
+ * Regex for valid semver strings (major.minor.patch).
+ * Examples: 1.0.0, 2.3.1, 10.20.30
+ */
+export declare const SEMVER_REGEX: RegExp;
+/**
+ * Origin of a skill version - how the version was created.
+ * - manual: Created through the UI
+ * - pr: Created from a pull request (via CI/CD API)
+ * - master: Synced from the main branch (via CI/CD API)
+ */
+export declare const SkillVersionOriginSchema: z.ZodEnum<{
+    manual: "manual";
+    pr: "pr";
+    master: "master";
+}>;
+export type SkillVersionOrigin = z.infer<typeof SkillVersionOriginSchema>;
 /**
  * Check if a string is a valid skill folder name (kebab-case).
  * Used for validation when creating skills and when writing skills to filesystem.
@@ -27,34 +44,96 @@ export declare const SkillMetadataSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type SkillMetadata = z.infer<typeof SkillMetadataSchema>;
 /**
- * Skill version - historical snapshot of a Skill's content.
+ * GitHub source reference for a skill directory.
+ * Points to a folder in a public GitHub repo containing SKILL.md and optional references.
+ */
+export declare const GitHubSourceSchema: z.ZodObject<{
+    owner: z.ZodString;
+    repo: z.ZodString;
+    path: z.ZodString;
+    ref: z.ZodString;
+}, z.core.$strip>;
+export type GitHubSource = z.infer<typeof GitHubSourceSchema>;
+/**
+ * A single file within a skill directory snapshot.
+ */
+export declare const SkillFileSchema: z.ZodObject<{
+    path: z.ZodString;
+    content: z.ZodString;
+}, z.core.$strip>;
+export type SkillFile = z.infer<typeof SkillFileSchema>;
+/**
+ * Skill version - immutable snapshot of a Skill's content.
+ *
+ * New versions store a `files` array (snapshot of the skill directory from GitHub)
+ * and a `source` reference (where the snapshot came from).
+ *
+ * Versions are immutable - editing creates a new version.
  */
 export declare const SkillVersionSchema: z.ZodObject<{
     id: z.ZodString;
+    projectId: z.ZodString;
     skillId: z.ZodString;
-    skillMd: z.ZodString;
-    metadata: z.ZodObject<{
-        name: z.ZodString;
-        description: z.ZodString;
-        allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip>;
-    model: z.ZodOptional<z.ZodObject<{
-        model: z.ZodEnum<typeof import("../common/models.js").ModelIds>;
-        temperature: z.ZodOptional<z.ZodNumber>;
-        maxTokens: z.ZodOptional<z.ZodNumber>;
+    version: z.ZodString;
+    origin: z.ZodEnum<{
+        manual: "manual";
+        pr: "pr";
+        master: "master";
+    }>;
+    source: z.ZodOptional<z.ZodObject<{
+        owner: z.ZodString;
+        repo: z.ZodString;
+        path: z.ZodString;
+        ref: z.ZodString;
     }, z.core.$strip>>;
-    systemPrompt: z.ZodOptional<z.ZodString>;
-    version: z.ZodNumber;
-    createdAt: z.ZodString;
+    files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        content: z.ZodString;
+    }, z.core.$strip>>>;
     notes: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
 }, z.core.$strip>;
 export type SkillVersion = z.infer<typeof SkillVersionSchema>;
 /**
- * Skill schema - a coding capability defined by SKILL.md.
+ * Input schema for creating a new SkillVersion.
+ *
+ * For source-based creation: provide `source` (or omit to use the Skill's source).
+ * The backend fetches the folder and stores the snapshot as `files`.
+ * For inline creation: provide `files` with the SKILL.md content.
+ *
+ * `version` is required -- the caller must always provide an explicit version string.
+ */
+export declare const CreateSkillVersionInputSchema: z.ZodObject<{
+    source: z.ZodOptional<z.ZodObject<{
+        owner: z.ZodString;
+        repo: z.ZodString;
+        path: z.ZodString;
+        ref: z.ZodString;
+    }, z.core.$strip>>;
+    version: z.ZodString;
+    notes: z.ZodOptional<z.ZodString>;
+    origin: z.ZodOptional<z.ZodEnum<{
+        manual: "manual";
+        pr: "pr";
+        master: "master";
+    }>>;
+    files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        content: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type CreateSkillVersionInput = z.infer<typeof CreateSkillVersionInputSchema>;
+/**
+ * Skill schema - a lightweight container for a coding capability.
+ *
+ * Skills are containers identified by a kebab-case name.
+ * All content (files, notes, etc.) lives in SkillVersion.
+ * The `source` field points to the GitHub directory for live fetching.
+ * Persisted shape: id, projectId, name, source, createdAt, updatedAt, deleted.
  *
- * Skills represent coding capabilities that can be tested.
- * Persisted shape: id, projectId, name, description, createdAt, updatedAt, deleted, skillMd.
+ * Note: `description` is inherited from BaseEntity. It's not stored in the DB
+ * for skills (content lives in SkillVersion), but is kept on the type to
+ * satisfy the TenantEntity constraint. The repository always returns "".
  */
 export declare const SkillSchema: z.ZodObject<{
     id: z.ZodString;
@@ -64,17 +143,73 @@ export declare const SkillSchema: z.ZodObject<{
     updatedAt: z.ZodString;
     deleted: z.ZodOptional<z.ZodBoolean>;
     projectId: z.ZodString;
-    skillMd: z.ZodString;
+    source: z.ZodOptional<z.ZodObject<{
+        owner: z.ZodString;
+        repo: z.ZodString;
+        path: z.ZodString;
+        ref: z.ZodString;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type Skill = z.infer<typeof SkillSchema>;
+/**
+ * Inline initial version data provided when creating a skill atomically.
+ * When present on a POST /skills request, the backend creates the skill
+ * and its first version in a single request with rollback on failure.
+ */
+export declare const InitialVersionInputSchema: z.ZodObject<{
+    files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        content: z.ZodString;
+    }, z.core.$strip>>>;
+    notes: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodObject<{
+        owner: z.ZodString;
+        repo: z.ZodString;
+        path: z.ZodString;
+        ref: z.ZodString;
+    }, z.core.$strip>>;
+    version: z.ZodOptional<z.ZodString>;
+    origin: z.ZodOptional<z.ZodEnum<{
+        manual: "manual";
+        pr: "pr";
+        master: "master";
+    }>>;
+}, z.core.$strip>;
+export type InitialVersionInput = z.infer<typeof InitialVersionInputSchema>;
 /**
  * Input schema for creating a new Skill.
+ * Only `name` and `projectId` are required. `description` is ignored (lives in SkillVersion).
+ * Pass `initialVersion` to atomically create the skill and its first version.
  */
 export declare const CreateSkillInputSchema: z.ZodObject<{
     name: z.ZodString;
-    description: z.ZodString;
     projectId: z.ZodString;
-    skillMd: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodObject<{
+        owner: z.ZodString;
+        repo: z.ZodString;
+        path: z.ZodString;
+        ref: z.ZodString;
+    }, z.core.$strip>>;
+    initialVersion: z.ZodOptional<z.ZodObject<{
+        files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            content: z.ZodString;
+        }, z.core.$strip>>>;
+        notes: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodObject<{
+            owner: z.ZodString;
+            repo: z.ZodString;
+            path: z.ZodString;
+            ref: z.ZodString;
+        }, z.core.$strip>>;
+        version: z.ZodOptional<z.ZodString>;
+        origin: z.ZodOptional<z.ZodEnum<{
+            manual: "manual";
+            pr: "pr";
+            master: "master";
+        }>>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type CreateSkillInput = z.infer<typeof CreateSkillInputSchema>;
 /**
@@ -82,8 +217,56 @@ export type CreateSkillInput = z.infer<typeof CreateSkillInputSchema>;
  */
 export declare const UpdateSkillInputSchema: z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
-    description: z.ZodOptional<z.ZodString>;
     projectId: z.ZodOptional<z.ZodString>;
-    skillMd: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    source: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+        owner: z.ZodString;
+        repo: z.ZodString;
+        path: z.ZodString;
+        ref: z.ZodString;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type UpdateSkillInput = z.infer<typeof UpdateSkillInputSchema>;
+/**
+ * Skill with its latest version - used when displaying skills in the UI
+ * and in the evaluator to access skill content.
+ */
+export declare const SkillWithLatestVersionSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    deleted: z.ZodOptional<z.ZodBoolean>;
+    projectId: z.ZodString;
+    source: z.ZodOptional<z.ZodObject<{
+        owner: z.ZodString;
+        repo: z.ZodString;
+        path: z.ZodString;
+        ref: z.ZodString;
+    }, z.core.$strip>>;
+    latestVersion: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        projectId: z.ZodString;
+        skillId: z.ZodString;
+        version: z.ZodString;
+        origin: z.ZodEnum<{
+            manual: "manual";
+            pr: "pr";
+            master: "master";
+        }>;
+        source: z.ZodOptional<z.ZodObject<{
+            owner: z.ZodString;
+            repo: z.ZodString;
+            path: z.ZodString;
+            ref: z.ZodString;
+        }, z.core.$strip>>;
+        files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            content: z.ZodString;
+        }, z.core.$strip>>>;
+        notes: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SkillWithLatestVersion = z.infer<typeof SkillWithLatestVersionSchema>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/evalforge-types",
-  "version": "0.25.0",
+  "version": "0.26.0",
   "description": "Unified types for EvalForge agent evaluation system",
   "files": [
     "build"
@@ -46,5 +46,5 @@
       "artifactId": "evalforge-types"
     }
   },
-  "falconPackageHash": "bbfbda873b35e09a1e099217c9d01a6731e9a2eb337d3ab1bf144e55"
+  "falconPackageHash": "56e0bd74e36bca477c117097436fb8e803b50b05613ca7864664e53f"
 }