@wix/evalforge-types 0.24.0 → 0.26.0

package/build/index.mjs

@@ -16,9 +16,9 @@ var TenantEntitySchema = BaseEntitySchema.extend({
 import { z as z2 } from "zod";
 var MCP_SERVERS_JSON_KEY = "mcpServers";
 var MCPEntitySchema = TenantEntitySchema.extend({
-  /** Display name and key in mcp.json mcpServers object */
+  /** Display name for the MCP entity (independent of the server key in config) */
   name: z2.string().min(1),
-  /** MCP server config (command/args, url/headers, etc.) - stored as-is for mcp.json */
+  /** Keyed MCP server config — top-level key is the server name, value is its config */
   config: z2.record(z2.string(), z2.unknown())
 });
 var CreateMcpInputSchema = MCPEntitySchema.omit({
@@ -154,6 +154,8 @@ var UpdateAgentInputSchema = CreateAgentInputSchema.partial().extend({
 // src/target/skill.ts
 import { z as z5 } from "zod";
 var SKILL_FOLDER_NAME_REGEX = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+var SEMVER_REGEX = /^\d+\.\d+\.\d+$/;
+var SkillVersionOriginSchema = z5.enum(["manual", "pr", "master"]);
 function isValidSkillFolderName(name) {
   return typeof name === "string" && name.length > 0 && SKILL_FOLDER_NAME_REGEX.test(name.trim());
 }
@@ -163,36 +165,87 @@ var SkillMetadataSchema = z5.object({
   allowedTools: z5.array(z5.string()).optional(),
   skills: z5.array(z5.string()).optional()
 });
+var GitHubSourceSchema = z5.object({
+  /** GitHub org or user, e.g. "wix" */
+  owner: z5.string().min(1),
+  /** Repository name, e.g. "skills" */
+  repo: z5.string().min(1),
+  /** Folder path to the skill directory, e.g. "wix-cli/skills/wix-cli-dashboard-page" */
+  path: z5.string().min(1),
+  /** Git ref (branch, tag, or SHA), e.g. "master" or "v1.2.0" */
+  ref: z5.string().min(1)
+});
+var SkillFileSchema = z5.object({
+  /** Relative path within the skill directory, e.g. "SKILL.md" or "references/API_SPEC.md" */
+  path: z5.string().min(1),
+  /** File content (UTF-8 text) */
+  content: z5.string()
+});
 var SkillVersionSchema = z5.object({
   id: z5.string(),
+  projectId: z5.string(),
   skillId: z5.string(),
-  skillMd: z5.string(),
-  metadata: SkillMetadataSchema,
-  model: ModelConfigSchema.optional(),
-  systemPrompt: z5.string().optional(),
-  version: z5.number(),
-  createdAt: z5.string(),
-  notes: z5.string().optional()
+  /** Semver string (e.g. "1.2.0") or Falcon fingerprint */
+  version: z5.string(),
+  /** How this version was created */
+  origin: SkillVersionOriginSchema,
+  /** Where this snapshot was taken from */
+  source: GitHubSourceSchema.optional(),
+  /** Frozen snapshot of all files in the skill directory */
+  files: z5.array(SkillFileSchema).optional(),
+  /** Optional notes about this version (changelog, reason for change) */
+  notes: z5.string().optional(),
+  createdAt: z5.string()
+});
+var CreateSkillVersionInputSchema = z5.object({
+  /** GitHub source to snapshot from. If not provided, uses the Skill's source. */
+  source: GitHubSourceSchema.optional(),
+  /** Version string for this snapshot (e.g. "1.0.0", "1.0.3"). */
+  version: z5.string().min(1),
+  notes: z5.string().optional(),
+  /** Origin of this version. Defaults to 'manual' in backend. */
+  origin: SkillVersionOriginSchema.optional(),
+  /** Pre-edited files to store directly (bypasses GitHub fetch when provided) */
+  files: z5.array(SkillFileSchema).optional()
 });
 var SkillSchema = TargetSchema.extend({
-  /** The current SKILL.md content */
-  skillMd: z5.string()
+  /** GitHub source reference for live content fetching */
+  source: GitHubSourceSchema.optional()
 });
 var KEBAB_CASE_MESSAGE = "Name must be in kebab-case (lowercase letters, numbers, hyphens only, e.g. my-skill)";
 var SkillInputBaseSchema = SkillSchema.omit({
   id: true,
   createdAt: true,
   updatedAt: true,
-  deleted: true
+  deleted: true,
+  description: true,
+  source: true
+}).extend({
+  /** Optional - not stored on Skill; content description lives in SkillVersion */
+  description: z5.string().optional(),
+  /** GitHub source reference for live content fetching */
+  source: GitHubSourceSchema.optional()
+});
+var InitialVersionInputSchema = z5.object({
+  files: z5.array(SkillFileSchema).optional(),
+  notes: z5.string().optional(),
+  source: GitHubSourceSchema.optional(),
+  version: z5.string().optional(),
+  origin: SkillVersionOriginSchema.optional()
+});
+var CreateSkillInputSchema = SkillInputBaseSchema.extend({
+  initialVersion: InitialVersionInputSchema.optional()
+}).refine((data) => isValidSkillFolderName(data.name), {
+  message: KEBAB_CASE_MESSAGE,
+  path: ["name"]
 });
-var CreateSkillInputSchema = SkillInputBaseSchema.refine(
-  (data) => isValidSkillFolderName(data.name),
-  { message: KEBAB_CASE_MESSAGE, path: ["name"] }
-);
 var UpdateSkillInputSchema = SkillInputBaseSchema.partial().refine(
   (data) => data.name === void 0 || isValidSkillFolderName(data.name),
   { message: KEBAB_CASE_MESSAGE, path: ["name"] }
 );
+var SkillWithLatestVersionSchema = SkillSchema.extend({
+  latestVersion: SkillVersionSchema.optional()
+});
 
 // src/target/skills-group.ts
 import { z as z6 } from "zod";
@@ -411,7 +464,7 @@ import { z as z19 } from "zod";
 var SkillWasCalledAssertionSchema = z19.object({
   type: z19.literal("skill_was_called"),
   /** Names of the skills that must have been called (matched against trace Skill tool args) */
-  skillNames: z19.array(z19.string()).min(1)
+  skillNames: z19.array(z19.string().min(1)).min(1)
 });
 var BuildPassedAssertionSchema = z19.object({
   type: z19.literal("build_passed"),
@@ -881,6 +934,8 @@ var EvalRunSchema = TenantEntitySchema.extend({
   agentId: z26.string().optional(),
   /** Skills group ID for this run */
   skillsGroupId: z26.string().optional(),
+  /** Map of skillId to skillVersionId for this run */
+  skillVersions: z26.record(z26.string(), z26.string()).optional(),
   /** Scenario IDs to run */
   scenarioIds: z26.array(z26.string()),
   /** Current status */
@@ -978,6 +1033,10 @@ var EvalRunResultSchema = z27.object({
   id: z27.string(),
   targetId: z27.string(),
   targetName: z27.string().optional(),
+  /** SkillVersion ID used for this evaluation (for version tracking) */
+  skillVersionId: z27.string().optional(),
+  /** SkillVersion semver string (e.g., "1.0.0", "1.2.3") for display */
+  skillVersion: z27.string().optional(),
   scenarioId: z27.string(),
   scenarioName: z27.string(),
   modelConfig: ModelConfigSchema.optional(),
@@ -1197,6 +1256,7 @@ export {
   CreateMcpInputSchema,
   CreateProjectInputSchema,
   CreateSkillInputSchema,
+  CreateSkillVersionInputSchema,
   CreateSkillsGroupInputSchema,
   CreateSubAgentInputSchema,
   CreateTemplateInputSchema,
@@ -1224,6 +1284,8 @@ export {
   FileContentTestSchema,
   FileModificationSchema,
   FilePresenceTestSchema,
+  GitHubSourceSchema,
+  InitialVersionInputSchema,
   LLMBreakdownStatsSchema,
   LLMStepType,
   LLMTestSchema,
@@ -1249,16 +1311,20 @@ export {
   PlaywrightNLTestSchema,
   ProjectSchema,
   PromptResultSchema,
+  SEMVER_REGEX,
   SKILL_FOLDER_NAME_REGEX,
   SYSTEM_ASSERTIONS,
   SYSTEM_ASSERTION_IDS,
   ScenarioAssertionLinkSchema,
   SiteConfigTestSchema,
+  SkillFileSchema,
   SkillMetadataSchema,
   SkillSchema,
+  SkillVersionOriginSchema,
   SkillVersionSchema,
   SkillWasCalledAssertionSchema,
   SkillWasCalledConfigSchema,
+  SkillWithLatestVersionSchema,
   SkillsGroupSchema,
   SubAgentSchema,
   TRACE_EVENT_PREFIX,