@renai-labs/sdk 0.1.20 → 0.1.21

package/dist/generated/zod.gen.d.ts

@@ -1161,6 +1161,13 @@ export declare const zTopology: z.ZodObject<{
         address: z.ZodEmail;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
+export declare const zSkillVersionFiles: z.ZodObject<{
+    type: z.ZodLiteral<"files">;
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        contentBase64: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 export declare const zSkillVersion: z.ZodObject<{
     id: z.ZodString;
     skillId: z.ZodString;
@@ -1170,7 +1177,7 @@ export declare const zSkillVersion: z.ZodObject<{
     archivedAt: z.ZodNullable<z.ZodISODateTime>;
     source: z.ZodUnion<readonly [z.ZodObject<{
         type: z.ZodLiteral<"s3">;
-        url: z.ZodURL;
+        key: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"git">;
         url: z.ZodURL;
@@ -1182,7 +1189,44 @@ export declare const zSkillVersion: z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     releaseNotes: z.ZodNullable<z.ZodString>;
-    contentHash: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const zSkillArchiveResult: z.ZodObject<{
+    id: z.ZodString;
+    slug: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    icon: z.ZodNullable<z.ZodString>;
+    docUrl: z.ZodNullable<z.ZodString>;
+    repository: z.ZodNullable<z.ZodObject<{
+        url: z.ZodOptional<z.ZodURL>;
+        source: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    orgId: z.ZodString;
+    userId: z.ZodNullable<z.ZodString>;
+    publisherId: z.ZodNullable<z.ZodString>;
+    parentId: z.ZodNullable<z.ZodString>;
+    websiteMetadata: z.ZodNullable<z.ZodObject<{
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        longDescription: z.ZodOptional<z.ZodString>;
+        image: z.ZodOptional<z.ZodURL>;
+        favicon: z.ZodOptional<z.ZodURL>;
+        supportUrl: z.ZodOptional<z.ZodURL>;
+        privacyPolicyUrl: z.ZodOptional<z.ZodURL>;
+    }, z.core.$strip>>;
+    sortOrder: z.ZodNullable<z.ZodInt>;
+    popularityScore: z.ZodNullable<z.ZodInt>;
+    trendingScore: z.ZodNullable<z.ZodInt>;
+    rank: z.ZodNullable<z.ZodInt>;
+    latestVersionId: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodISODateTime;
+    updatedAt: z.ZodISODateTime;
+    archivedAt: z.ZodNullable<z.ZodISODateTime>;
+    deprecatedAt: z.ZodNullable<z.ZodISODateTime>;
+    deprecationMessage: z.ZodNullable<z.ZodString>;
+    tags: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    agentCount: z.ZodInt;
+    projectCount: z.ZodInt;
 }, z.core.$strip>;
 export declare const zSkill: z.ZodObject<{
     id: z.ZodString;
@@ -1541,6 +1585,32 @@ export declare const zProjectMcp: z.ZodObject<{
     createdAt: z.ZodISODateTime;
     updatedAt: z.ZodISODateTime;
 }, z.core.$strip>;
+export declare const zSkillPinConflict: z.ZodObject<{
+    skillSlug: z.ZodString;
+    pinnedVersion: z.ZodString;
+    effectiveVersion: z.ZodString;
+    reason: z.ZodEnum<{
+        outranked: "outranked";
+        "pin-archived": "pin-archived";
+    }>;
+}, z.core.$strip>;
+export declare const zProjectSkillResolution: z.ZodObject<{
+    skills: z.ZodArray<z.ZodObject<{
+        skillId: z.ZodString;
+        skillSlug: z.ZodString;
+        effectiveVersionId: z.ZodString;
+        effectiveVersion: z.ZodString;
+    }, z.core.$strip>>;
+    conflicts: z.ZodArray<z.ZodObject<{
+        skillSlug: z.ZodString;
+        pinnedVersion: z.ZodString;
+        effectiveVersion: z.ZodString;
+        reason: z.ZodEnum<{
+            outranked: "outranked";
+            "pin-archived": "pin-archived";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 export declare const zProjectSkill: z.ZodObject<{
     id: z.ZodString;
     projectId: z.ZodString;
@@ -13852,6 +13922,29 @@ export declare const zProjectSkillAddResponse: z.ZodObject<{
     createdAt: z.ZodISODateTime;
     updatedAt: z.ZodISODateTime;
 }, z.core.$strip>;
+export declare const zProjectSkillResolutionPath: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Effective versions and pin-conflict warnings
+ */
+export declare const zProjectSkillResolutionResponse: z.ZodObject<{
+    skills: z.ZodArray<z.ZodObject<{
+        skillId: z.ZodString;
+        skillSlug: z.ZodString;
+        effectiveVersionId: z.ZodString;
+        effectiveVersion: z.ZodString;
+    }, z.core.$strip>>;
+    conflicts: z.ZodArray<z.ZodObject<{
+        skillSlug: z.ZodString;
+        pinnedVersion: z.ZodString;
+        effectiveVersion: z.ZodString;
+        reason: z.ZodEnum<{
+            outranked: "outranked";
+            "pin-archived": "pin-archived";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 export declare const zProjectSkillRemovePath: z.ZodObject<{
     id: z.ZodString;
     skillId: z.ZodString;
@@ -14946,6 +15039,10 @@ export declare const zSkillListQuery: z.ZodObject<{
         org: "org";
         private: "private";
     }>>;
+    query: z.ZodOptional<z.ZodString>;
+    published: z.ZodOptional<z.ZodBoolean>;
+    publisherId: z.ZodOptional<z.ZodString>;
+    tagged: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
 }, z.core.$strip>;
 /**
  * List of skills
@@ -14988,38 +15085,15 @@ export declare const zSkillListResponse: z.ZodArray<z.ZodObject<{
 }, z.core.$strip>>;
 export declare const zSkillCreateBody: z.ZodObject<{
     slug: z.ZodOptional<z.ZodString>;
-    name: z.ZodString;
-    description: z.ZodOptional<z.ZodString>;
-    icon: z.ZodOptional<z.ZodString>;
-    tags: z.ZodOptional<z.ZodString>;
-    requiredCredentials: z.ZodOptional<z.ZodString>;
-    releaseNotes: z.ZodOptional<z.ZodString>;
-    source: z.ZodOptional<z.ZodString>;
-    visibility: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
-        org: "org";
-        private: "private";
-    }>>>;
-    files: z.ZodArray<z.ZodString>;
-}, z.core.$strip>;
-/**
- * Created skill
- */
-export declare const zSkillCreateResponse: z.ZodObject<{
-    id: z.ZodString;
-    slug: z.ZodString;
-    name: z.ZodString;
-    description: z.ZodNullable<z.ZodString>;
-    icon: z.ZodNullable<z.ZodString>;
-    docUrl: z.ZodNullable<z.ZodString>;
-    repository: z.ZodNullable<z.ZodObject<{
+    nameOverride: z.ZodOptional<z.ZodString>;
+    descriptionOverride: z.ZodOptional<z.ZodString>;
+    icon: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    docUrl: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodURL>>>;
+    repository: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
         url: z.ZodOptional<z.ZodURL>;
         source: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-    orgId: z.ZodString;
-    userId: z.ZodNullable<z.ZodString>;
-    publisherId: z.ZodNullable<z.ZodString>;
-    parentId: z.ZodNullable<z.ZodString>;
-    websiteMetadata: z.ZodNullable<z.ZodObject<{
+    }, z.core.$strip>>>>;
+    websiteMetadata: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
         title: z.ZodOptional<z.ZodString>;
         description: z.ZodOptional<z.ZodString>;
         longDescription: z.ZodOptional<z.ZodString>;
@@ -15027,51 +15101,33 @@ export declare const zSkillCreateResponse: z.ZodObject<{
         favicon: z.ZodOptional<z.ZodURL>;
         supportUrl: z.ZodOptional<z.ZodURL>;
         privacyPolicyUrl: z.ZodOptional<z.ZodURL>;
+    }, z.core.$strip>>>>;
+    version: z.ZodOptional<z.ZodString>;
+    releaseNotes: z.ZodOptional<z.ZodString>;
+    requiredCredentials: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        contentBase64: z.ZodString;
+    }, z.core.$strip>>>;
+    source: z.ZodOptional<z.ZodObject<{
+        type: z.ZodLiteral<"git">;
+        url: z.ZodURL;
+        ref: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
-    sortOrder: z.ZodNullable<z.ZodInt>;
-    popularityScore: z.ZodNullable<z.ZodInt>;
-    trendingScore: z.ZodNullable<z.ZodInt>;
-    rank: z.ZodNullable<z.ZodInt>;
-    latestVersionId: z.ZodNullable<z.ZodString>;
-    createdAt: z.ZodISODateTime;
-    updatedAt: z.ZodISODateTime;
-    archivedAt: z.ZodNullable<z.ZodISODateTime>;
-    deprecatedAt: z.ZodNullable<z.ZodISODateTime>;
-    deprecationMessage: z.ZodNullable<z.ZodString>;
-    tags: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
-}, z.core.$strip>;
-export declare const zSkillSearchBody: z.ZodObject<{
-    query: z.ZodOptional<z.ZodString>;
-    sources: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodEnum<{
-        org: "org";
-        user: "user";
-        registry: "registry";
-    }>>>>;
-    limit: z.ZodDefault<z.ZodOptional<z.ZodInt>>;
-}, z.core.$strip>;
-/**
- * Matching skills
- */
-export declare const zSkillSearchResponse: z.ZodArray<z.ZodObject<{
-    id: z.ZodString;
-    slug: z.ZodString;
-    name: z.ZodString;
-    description: z.ZodNullable<z.ZodString>;
-    icon: z.ZodNullable<z.ZodString>;
-    source: z.ZodEnum<{
+    visibility: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
         org: "org";
-        user: "user";
-        registry: "registry";
-    }>;
-    updatedAt: z.ZodISODateTime;
-}, z.core.$strip>>;
-export declare const zSkillGetBySlugPath: z.ZodObject<{
-    slug: z.ZodString;
+        private: "private";
+    }>>>;
 }, z.core.$strip>;
 /**
- * Skill details
+ * Created skill
  */
-export declare const zSkillGetBySlugResponse: z.ZodObject<{
+export declare const zSkillCreateResponse: z.ZodObject<{
     id: z.ZodString;
     slug: z.ZodString;
     name: z.ZodString;
@@ -15108,7 +15164,7 @@ export declare const zSkillGetBySlugResponse: z.ZodObject<{
     tags: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
 }, z.core.$strip>;
 export declare const zSkillGetPath: z.ZodObject<{
-    id: z.ZodString;
+    idOrSlug: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
 }, z.core.$strip>;
 /**
  * Skill details
@@ -15151,7 +15207,7 @@ export declare const zSkillGetResponse: z.ZodObject<{
 }, z.core.$strip>;
 export declare const zSkillUpdateBody: z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
-    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodOptional<z.ZodString>;
     icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     docUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     repository: z.ZodOptional<z.ZodNullable<z.ZodObject<{
@@ -15215,7 +15271,7 @@ export declare const zSkillArchivePath: z.ZodObject<{
     id: z.ZodString;
 }, z.core.$strip>;
 /**
- * Archived skill
+ * Archived skill with the blast radius of agents and projects that referenced it
  */
 export declare const zSkillArchiveResponse: z.ZodObject<{
     id: z.ZodString;
@@ -15252,6 +15308,8 @@ export declare const zSkillArchiveResponse: z.ZodObject<{
     deprecatedAt: z.ZodNullable<z.ZodISODateTime>;
     deprecationMessage: z.ZodNullable<z.ZodString>;
     tags: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    agentCount: z.ZodInt;
+    projectCount: z.ZodInt;
 }, z.core.$strip>;
 export declare const zSkillPublishPath: z.ZodObject<{
     id: z.ZodString;
@@ -15494,7 +15552,7 @@ export declare const zSkillVersionListResponse: z.ZodArray<z.ZodObject<{
     archivedAt: z.ZodNullable<z.ZodISODateTime>;
     source: z.ZodUnion<readonly [z.ZodObject<{
         type: z.ZodLiteral<"s3">;
-        url: z.ZodURL;
+        key: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"git">;
         url: z.ZodURL;
@@ -15506,14 +15564,28 @@ export declare const zSkillVersionListResponse: z.ZodArray<z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     releaseNotes: z.ZodNullable<z.ZodString>;
-    contentHash: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>>;
 export declare const zSkillVersionCreateBody: z.ZodObject<{
-    version: z.ZodOptional<z.ZodString>;
+    version: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodEnum<{
+        patch: "patch";
+        major: "major";
+        minor: "minor";
+    }>]>>>;
     releaseNotes: z.ZodOptional<z.ZodString>;
-    requiredCredentials: z.ZodOptional<z.ZodString>;
-    source: z.ZodOptional<z.ZodString>;
-    files: z.ZodArray<z.ZodString>;
+    requiredCredentials: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>>;
+    files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        contentBase64: z.ZodString;
+    }, z.core.$strip>>>;
+    source: z.ZodOptional<z.ZodObject<{
+        type: z.ZodLiteral<"git">;
+        url: z.ZodURL;
+        ref: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const zSkillVersionCreatePath: z.ZodObject<{
     id: z.ZodString;
@@ -15530,7 +15602,7 @@ export declare const zSkillVersionCreateResponse: z.ZodObject<{
     archivedAt: z.ZodNullable<z.ZodISODateTime>;
     source: z.ZodUnion<readonly [z.ZodObject<{
         type: z.ZodLiteral<"s3">;
-        url: z.ZodURL;
+        key: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"git">;
         url: z.ZodURL;
@@ -15542,7 +15614,6 @@ export declare const zSkillVersionCreateResponse: z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     releaseNotes: z.ZodNullable<z.ZodString>;
-    contentHash: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
 export declare const zSkillVersionGetPath: z.ZodObject<{
     id: z.ZodString;
@@ -15560,7 +15631,7 @@ export declare const zSkillVersionGetResponse: z.ZodObject<{
     archivedAt: z.ZodNullable<z.ZodISODateTime>;
     source: z.ZodUnion<readonly [z.ZodObject<{
         type: z.ZodLiteral<"s3">;
-        url: z.ZodURL;
+        key: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"git">;
         url: z.ZodURL;
@@ -15572,28 +15643,20 @@ export declare const zSkillVersionGetResponse: z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     releaseNotes: z.ZodNullable<z.ZodString>;
-    contentHash: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
 export declare const zSkillVersionDataPath: z.ZodObject<{
     id: z.ZodString;
     version: z.ZodString;
 }, z.core.$strip>;
-export declare const zSkillVersionDataQuery: z.ZodObject<{
-    format: z.ZodOptional<z.ZodEnum<{
-        json: "json";
-        presigned: "presigned";
-    }>>;
-}, z.core.$strip>;
 /**
- * Extracted files, presigned URL, or git source descriptor
+ * One shape per skill kind: file-backed versions return their files base64-encoded (binary-safe); git-backed versions return the git source pointer verbatim (Read fix #1).
  */
 export declare const zSkillVersionDataResponse: z.ZodUnion<readonly [z.ZodObject<{
+    type: z.ZodLiteral<"files">;
     files: z.ZodArray<z.ZodObject<{
         path: z.ZodString;
-        content: z.ZodString;
+        contentBase64: z.ZodString;
     }, z.core.$strip>>;
-}, z.core.$strip>, z.ZodObject<{
-    url: z.ZodURL;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"git">;
     url: z.ZodURL;
@@ -15616,7 +15679,7 @@ export declare const zSkillVersionArchiveResponse: z.ZodObject<{
     archivedAt: z.ZodNullable<z.ZodISODateTime>;
     source: z.ZodUnion<readonly [z.ZodObject<{
         type: z.ZodLiteral<"s3">;
-        url: z.ZodURL;
+        key: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"git">;
         url: z.ZodURL;
@@ -15628,7 +15691,6 @@ export declare const zSkillVersionArchiveResponse: z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     releaseNotes: z.ZodNullable<z.ZodString>;
-    contentHash: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
 /**
  * Agent-stack topology

package/dist/generated/zod.gen.js

@@ -773,6 +773,13 @@ export const zTopology = z.object({
     }))
         .optional(),
 });
+export const zSkillVersionFiles = z.object({
+    type: z.literal("files"),
+    files: z.array(z.object({
+        path: z.string(),
+        contentBase64: z.string(),
+    })),
+});
 export const zSkillVersion = z.object({
     id: z.string(),
     skillId: z.string(),
@@ -788,7 +795,7 @@ export const zSkillVersion = z.object({
     source: z.union([
         z.object({
             type: z.literal("s3"),
-            url: z.url(),
+            key: z.string(),
         }),
         z.object({
             type: z.literal("git"),
@@ -799,7 +806,43 @@ export const zSkillVersion = z.object({
     ]),
     requiredCredentials: z.array(zRequiredCredential),
     releaseNotes: z.string().nullable(),
-    contentHash: z.string().nullable(),
+});
+export const zSkillArchiveResult = z.object({
+    id: z.string(),
+    slug: z.string(),
+    name: z.string(),
+    description: z.string().nullable(),
+    icon: z.string().nullable(),
+    docUrl: z.string().nullable(),
+    repository: zRepository.nullable(),
+    orgId: z.string(),
+    userId: z.string().nullable(),
+    publisherId: z.string().nullable(),
+    parentId: z.string().nullable(),
+    websiteMetadata: zWebsiteMetadata.nullable(),
+    sortOrder: z.int().gte(-9007199254740991).lte(9007199254740991).nullable(),
+    popularityScore: z.int().gte(-9007199254740991).lte(9007199254740991).nullable(),
+    trendingScore: z.int().gte(-9007199254740991).lte(9007199254740991).nullable(),
+    rank: z.int().gte(-9007199254740991).lte(9007199254740991).nullable(),
+    latestVersionId: z.string().nullable(),
+    createdAt: z.iso
+        .datetime()
+        .regex(/^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$/),
+    updatedAt: z.iso
+        .datetime()
+        .regex(/^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$/),
+    archivedAt: z.iso
+        .datetime()
+        .regex(/^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$/)
+        .nullable(),
+    deprecatedAt: z.iso
+        .datetime()
+        .regex(/^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$/)
+        .nullable(),
+    deprecationMessage: z.string().nullable(),
+    tags: z.array(z.string()).optional().default([]),
+    agentCount: z.int().gte(-9007199254740991).lte(9007199254740991),
+    projectCount: z.int().gte(-9007199254740991).lte(9007199254740991),
 });
 export const zSkill = z.object({
     id: z.string(),
@@ -1072,6 +1115,21 @@ export const zProjectMcp = z.object({
         .datetime()
         .regex(/^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$/),
 });
+export const zSkillPinConflict = z.object({
+    skillSlug: z.string(),
+    pinnedVersion: z.string(),
+    effectiveVersion: z.string(),
+    reason: z.enum(["outranked", "pin-archived"]),
+});
+export const zProjectSkillResolution = z.object({
+    skills: z.array(z.object({
+        skillId: z.string(),
+        skillSlug: z.string(),
+        effectiveVersionId: z.string(),
+        effectiveVersion: z.string(),
+    })),
+    conflicts: z.array(zSkillPinConflict),
+});
 export const zProjectSkill = z.object({
     id: z.string(),
     projectId: z.string(),
@@ -3301,6 +3359,13 @@ export const zProjectSkillAddPath = z.object({
  * Attached skill
  */
 export const zProjectSkillAddResponse = zProjectSkill;
+export const zProjectSkillResolutionPath = z.object({
+    id: z.string().regex(/^prj_[0-9A-HJKMNP-TV-Z]{26}$/),
+});
+/**
+ * Effective versions and pin-conflict warnings
+ */
+export const zProjectSkillResolutionResponse = zProjectSkillResolution;
 export const zProjectSkillRemovePath = z.object({
     id: z.string().regex(/^prj_[0-9A-HJKMNP-TV-Z]{26}$/),
     skillId: z.string().regex(/^skl_[0-9A-HJKMNP-TV-Z]{26}$/),
@@ -3597,6 +3662,10 @@ export const zSkillListQuery = z.object({
     includeDeprecated: z.boolean().optional(),
     sort: z.enum(["popular", "trending", "recent"]).optional(),
     visibility: z.enum(["private", "org"]).optional(),
+    query: z.string().optional(),
+    published: z.boolean().optional(),
+    publisherId: z.string().optional(),
+    tagged: z.union([z.string(), z.array(z.string())]).optional(),
 });
 /**
  * List of skills
@@ -3604,54 +3673,56 @@ export const zSkillListQuery = z.object({
 export const zSkillListResponse = z.array(zSkill);
 export const zSkillCreateBody = z.object({
     slug: z.string().optional(),
-    name: z.string(),
-    description: z.string().optional(),
-    icon: z.string().optional(),
-    tags: z.string().optional(),
-    requiredCredentials: z.string().optional(),
+    nameOverride: z.string().min(1).optional(),
+    descriptionOverride: z.string().optional(),
+    icon: z.string().nullish().default(null),
+    docUrl: z.url().nullish().default(null),
+    repository: zRepository.nullish().default(null),
+    websiteMetadata: zWebsiteMetadata.nullish().default(null),
+    version: z.string().optional(),
     releaseNotes: z.string().optional(),
-    source: z.string().optional(),
+    requiredCredentials: z.array(zRequiredCredential).optional().default([]),
+    tags: z.array(z.string()).optional(),
+    files: z
+        .array(z.object({
+        path: z.string().min(1),
+        contentBase64: z
+            .string()
+            .regex(/^$|^(?:[0-9a-zA-Z+\/]{4})*(?:(?:[0-9a-zA-Z+\/]{2}==)|(?:[0-9a-zA-Z+\/]{3}=))?$/),
+    }))
+        .min(1)
+        .optional(),
+    source: z
+        .object({
+        type: z.literal("git"),
+        url: z.url(),
+        ref: z.string().optional(),
+        path: z.string().optional(),
+    })
+        .optional(),
     visibility: z.enum(["private", "org"]).optional().default("org"),
-    files: z.array(z.string()),
 });
 /**
  * Created skill
  */
 export const zSkillCreateResponse = zSkill;
-export const zSkillSearchBody = z.object({
-    query: z.string().optional(),
-    sources: z
-        .array(z.enum(["user", "org", "registry"]))
-        .min(1)
-        .optional()
-        .default(["user", "org", "registry"]),
-    limit: z.int().gte(1).lte(50).optional().default(20),
-});
-/**
- * Matching skills
- */
-export const zSkillSearchResponse = z.array(zSearchResult);
-export const zSkillGetBySlugPath = z.object({
-    slug: z
-        .string()
-        .min(1)
-        .max(128)
-        .regex(/^[a-z0-9-]+$/),
-});
-/**
- * Skill details
- */
-export const zSkillGetBySlugResponse = zSkill;
 export const zSkillGetPath = z.object({
-    id: z.string().regex(/^skl_[0-9A-HJKMNP-TV-Z]{26}$/),
+    idOrSlug: z.union([
+        z.string().regex(/^skl_[0-9A-HJKMNP-TV-Z]{26}$/),
+        z
+            .string()
+            .min(1)
+            .max(128)
+            .regex(/^[a-z0-9-]+$/),
+    ]),
 });
 /**
  * Skill details
  */
 export const zSkillGetResponse = zSkill;
 export const zSkillUpdateBody = z.object({
-    name: z.string().optional(),
-    description: z.string().nullish(),
+    name: z.string().min(1).optional(),
+    description: z.string().optional(),
     icon: z.string().nullish(),
     docUrl: z.string().nullish(),
     repository: zRepository.nullish(),
@@ -3669,9 +3740,9 @@ export const zSkillArchivePath = z.object({
     id: z.string().regex(/^skl_[0-9A-HJKMNP-TV-Z]{26}$/),
 });
 /**
- * Archived skill
+ * Archived skill with the blast radius of agents and projects that referenced it
  */
-export const zSkillArchiveResponse = zSkill;
+export const zSkillArchiveResponse = zSkillArchiveResult;
 export const zSkillPublishPath = z.object({
     id: z.string().regex(/^skl_[0-9A-HJKMNP-TV-Z]{26}$/),
 });
@@ -3728,11 +3799,29 @@ export const zSkillVersionListQuery = z.object({
  */
 export const zSkillVersionListResponse = z.array(zSkillVersion);
 export const zSkillVersionCreateBody = z.object({
-    version: z.string().optional(),
+    version: z
+        .union([z.string(), z.enum(["major", "minor", "patch"])])
+        .optional()
+        .default("patch"),
     releaseNotes: z.string().optional(),
-    requiredCredentials: z.string().optional(),
-    source: z.string().optional(),
-    files: z.array(z.string()),
+    requiredCredentials: z.array(zRequiredCredential).optional().default([]),
+    files: z
+        .array(z.object({
+        path: z.string().min(1),
+        contentBase64: z
+            .string()
+            .regex(/^$|^(?:[0-9a-zA-Z+\/]{4})*(?:(?:[0-9a-zA-Z+\/]{2}==)|(?:[0-9a-zA-Z+\/]{3}=))?$/),
+    }))
+        .min(1)
+        .optional(),
+    source: z
+        .object({
+        type: z.literal("git"),
+        url: z.url(),
+        ref: z.string().optional(),
+        path: z.string().optional(),
+    })
+        .optional(),
 });
 export const zSkillVersionCreatePath = z.object({
     id: z.string().regex(/^skl_[0-9A-HJKMNP-TV-Z]{26}$/),
@@ -3753,22 +3842,11 @@ export const zSkillVersionDataPath = z.object({
     id: z.string().regex(/^skl_[0-9A-HJKMNP-TV-Z]{26}$/),
     version: z.string().min(1).max(32),
 });
-export const zSkillVersionDataQuery = z.object({
-    format: z.enum(["json", "presigned"]).optional(),
-});
 /**
- * Extracted files, presigned URL, or git source descriptor
+ * One shape per skill kind: file-backed versions return their files base64-encoded (binary-safe); git-backed versions return the git source pointer verbatim (Read fix #1).
  */
 export const zSkillVersionDataResponse = z.union([
-    z.object({
-        files: z.array(z.object({
-            path: z.string().min(1),
-            content: z.string(),
-        })),
-    }),
-    z.object({
-        url: z.url(),
-    }),
+    zSkillVersionFiles,
     z.object({
         type: z.literal("git"),
         url: z.url(),