Implement skills store API foundation

Co-Authored-By: Paperclip <noreply@paperclip.ing>

ui/src/api/agents.ts

@@ -1,5 +1,6 @@
 import type {
   Agent,
+  AgentDesiredSkillEntry,
   AgentPermissions,
   AgentDetail,
   AgentInstructionsBundle,
@@ -174,7 +175,7 @@ export const agentsApi = {
   listKeys: (id: string, companyId?: string) => api.get<AgentKey[]>(agentPath(id, companyId, "/keys")),
   skills: (id: string, companyId?: string) =>
     api.get<AgentSkillSnapshot>(agentPath(id, companyId, "/skills")),
-  syncSkills: (id: string, desiredSkills: string[], companyId?: string) =>
+  syncSkills: (id: string, desiredSkills: Array<string | AgentDesiredSkillEntry>, companyId?: string) =>
     api.post<AgentSkillSnapshot>(agentPath(id, companyId, "/skills/sync"), { desiredSkills }),
   createKey: (id: string, name: string, companyId?: string) =>
     api.post<AgentKeyCreated>(agentPath(id, companyId, "/keys"), { name }),

ui/src/api/companySkills.ts

@@ -3,16 +3,25 @@ import type {
   CatalogSkillFileDetail,
   CatalogSkillKind,
   CompanySkill,
+  CompanySkillCategoryCount,
+  CompanySkillComment,
+  CompanySkillCommentCreateRequest,
+  CompanySkillCommentUpdateRequest,
   CompanySkillCreateRequest,
   CompanySkillDetail,
   CompanySkillFileDetail,
+  CompanySkillForkRequest,
   CompanySkillImportResult,
   CompanySkillInstallCatalogRequest,
   CompanySkillInstallCatalogResult,
+  CompanySkillListQuery,
   CompanySkillListItem,
   CompanySkillProjectScanRequest,
   CompanySkillProjectScanResult,
+  CompanySkillStarResult,
   CompanySkillUpdateStatus,
+  CompanySkillVersion,
+  CompanySkillVersionCreateRequest,
 } from "@paperclipai/shared";
 import { api } from "./client";
 
@@ -23,12 +32,66 @@ export interface CatalogListQuery {
 }
 
 export const companySkillsApi = {
-  list: (companyId: string) =>
-    api.get<CompanySkillListItem[]>(`/companies/${encodeURIComponent(companyId)}/skills`),
+  list: (companyId: string, query: CompanySkillListQuery = {}) => {
+    const params = new URLSearchParams();
+    if (query.q) params.set("q", query.q);
+    if (query.sort) params.set("sort", query.sort);
+    if (query.scope) params.set("scope", query.scope);
+    for (const category of query.categories ?? []) params.append("categories[]", category);
+    const search = params.toString();
+    return api.get<CompanySkillListItem[]>(`/companies/${encodeURIComponent(companyId)}/skills${search ? `?${search}` : ""}`);
+  },
+  categories: (companyId: string) =>
+    api.get<CompanySkillCategoryCount[]>(`/companies/${encodeURIComponent(companyId)}/skills/categories`),
   detail: (companyId: string, skillId: string) =>
     api.get<CompanySkillDetail>(
       `/companies/${encodeURIComponent(companyId)}/skills/${encodeURIComponent(skillId)}`,
     ),
+  versions: (companyId: string, skillId: string) =>
+    api.get<CompanySkillVersion[]>(
+      `/companies/${encodeURIComponent(companyId)}/skills/${encodeURIComponent(skillId)}/versions`,
+    ),
+  version: (companyId: string, skillId: string, versionId: string) =>
+    api.get<CompanySkillVersion>(
+      `/companies/${encodeURIComponent(companyId)}/skills/${encodeURIComponent(skillId)}/versions/${encodeURIComponent(versionId)}`,
+    ),
+  createVersion: (companyId: string, skillId: string, payload: CompanySkillVersionCreateRequest = {}) =>
+    api.post<CompanySkillVersion>(
+      `/companies/${encodeURIComponent(companyId)}/skills/${encodeURIComponent(skillId)}/versions`,
+      payload,
+    ),
+  star: (companyId: string, skillId: string) =>
+    api.post<CompanySkillStarResult>(
+      `/companies/${encodeURIComponent(companyId)}/skills/${encodeURIComponent(skillId)}/star`,
+      {},
+    ),
+  unstar: (companyId: string, skillId: string) =>
+    api.delete<CompanySkillStarResult>(
+      `/companies/${encodeURIComponent(companyId)}/skills/${encodeURIComponent(skillId)}/star`,
+    ),
+  fork: (companyId: string, skillId: string, payload: CompanySkillForkRequest = {}) =>
+    api.post<CompanySkill>(
+      `/companies/${encodeURIComponent(companyId)}/skills/${encodeURIComponent(skillId)}/fork`,
+      payload,
+    ),
+  comments: (companyId: string, skillId: string) =>
+    api.get<CompanySkillComment[]>(
+      `/companies/${encodeURIComponent(companyId)}/skills/${encodeURIComponent(skillId)}/comments`,
+    ),
+  createComment: (companyId: string, skillId: string, payload: CompanySkillCommentCreateRequest) =>
+    api.post<CompanySkillComment>(
+      `/companies/${encodeURIComponent(companyId)}/skills/${encodeURIComponent(skillId)}/comments`,
+      payload,
+    ),
+  updateComment: (companyId: string, skillId: string, commentId: string, payload: CompanySkillCommentUpdateRequest) =>
+    api.patch<CompanySkillComment>(
+      `/companies/${encodeURIComponent(companyId)}/skills/${encodeURIComponent(skillId)}/comments/${encodeURIComponent(commentId)}`,
+      payload,
+    ),
+  deleteComment: (companyId: string, skillId: string, commentId: string) =>
+    api.delete<CompanySkillComment>(
+      `/companies/${encodeURIComponent(companyId)}/skills/${encodeURIComponent(skillId)}/comments/${encodeURIComponent(commentId)}`,
+    ),
   updateStatus: (companyId: string, skillId: string) =>
     api.get<CompanySkillUpdateStatus>(
       `/companies/${encodeURIComponent(companyId)}/skills/${encodeURIComponent(skillId)}/update-status`,