Add company skills library and agent skills UI

packages/shared/src/index.ts

@@ -65,6 +65,16 @@ export {
 
 export type {
   Company,
+  CompanySkillSourceType,
+  CompanySkillTrustLevel,
+  CompanySkillCompatibility,
+  CompanySkillFileInventoryEntry,
+  CompanySkill,
+  CompanySkillListItem,
+  CompanySkillUsageAgent,
+  CompanySkillDetail,
+  CompanySkillImportRequest,
+  CompanySkillImportResult,
   AgentSkillSyncMode,
   AgentSkillState,
   AgentSkillEntry,
@@ -238,6 +248,15 @@ export {
   type ClaimJoinRequestApiKey,
   type UpdateMemberPermissions,
   type UpdateUserCompanyAccess,
+  companySkillSourceTypeSchema,
+  companySkillTrustLevelSchema,
+  companySkillCompatibilitySchema,
+  companySkillFileInventoryEntrySchema,
+  companySkillSchema,
+  companySkillListItemSchema,
+  companySkillUsageAgentSchema,
+  companySkillDetailSchema,
+  companySkillImportSchema,
   portabilityIncludeSchema,
   portabilityEnvInputSchema,
   portabilityCompanyManifestEntrySchema,

packages/shared/src/types/company-skill.ts

@@ -0,0 +1,55 @@
+export type CompanySkillSourceType = "local_path" | "github" | "url" | "catalog";
+
+export type CompanySkillTrustLevel = "markdown_only" | "assets" | "scripts_executables";
+
+export type CompanySkillCompatibility = "compatible" | "unknown" | "invalid";
+
+export interface CompanySkillFileInventoryEntry {
+  path: string;
+  kind: "skill" | "markdown" | "reference" | "script" | "asset" | "other";
+}
+
+export interface CompanySkill {
+  id: string;
+  companyId: string;
+  slug: string;
+  name: string;
+  description: string | null;
+  markdown: string;
+  sourceType: CompanySkillSourceType;
+  sourceLocator: string | null;
+  sourceRef: string | null;
+  trustLevel: CompanySkillTrustLevel;
+  compatibility: CompanySkillCompatibility;
+  fileInventory: CompanySkillFileInventoryEntry[];
+  metadata: Record<string, unknown> | null;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+export interface CompanySkillListItem extends CompanySkill {
+  attachedAgentCount: number;
+}
+
+export interface CompanySkillUsageAgent {
+  id: string;
+  name: string;
+  urlKey: string;
+  adapterType: string;
+  desired: boolean;
+  actualState: string | null;
+}
+
+export interface CompanySkillDetail extends CompanySkill {
+  attachedAgentCount: number;
+  usedByAgents: CompanySkillUsageAgent[];
+}
+
+export interface CompanySkillImportRequest {
+  source: string;
+}
+
+export interface CompanySkillImportResult {
+  imported: CompanySkill[];
+  warnings: string[];
+}

packages/shared/src/types/index.ts

@@ -1,4 +1,16 @@
 export type { Company } from "./company.js";
+export type {
+  CompanySkillSourceType,
+  CompanySkillTrustLevel,
+  CompanySkillCompatibility,
+  CompanySkillFileInventoryEntry,
+  CompanySkill,
+  CompanySkillListItem,
+  CompanySkillUsageAgent,
+  CompanySkillDetail,
+  CompanySkillImportRequest,
+  CompanySkillImportResult,
+} from "./company-skill.js";
 export type {
   AgentSkillSyncMode,
   AgentSkillState,

packages/shared/src/validators/company-skill.ts

@@ -0,0 +1,52 @@
+import { z } from "zod";
+
+export const companySkillSourceTypeSchema = z.enum(["local_path", "github", "url", "catalog"]);
+export const companySkillTrustLevelSchema = z.enum(["markdown_only", "assets", "scripts_executables"]);
+export const companySkillCompatibilitySchema = z.enum(["compatible", "unknown", "invalid"]);
+
+export const companySkillFileInventoryEntrySchema = z.object({
+  path: z.string().min(1),
+  kind: z.enum(["skill", "markdown", "reference", "script", "asset", "other"]),
+});
+
+export const companySkillSchema = z.object({
+  id: z.string().uuid(),
+  companyId: z.string().uuid(),
+  slug: z.string().min(1),
+  name: z.string().min(1),
+  description: z.string().nullable(),
+  markdown: z.string(),
+  sourceType: companySkillSourceTypeSchema,
+  sourceLocator: z.string().nullable(),
+  sourceRef: z.string().nullable(),
+  trustLevel: companySkillTrustLevelSchema,
+  compatibility: companySkillCompatibilitySchema,
+  fileInventory: z.array(companySkillFileInventoryEntrySchema).default([]),
+  metadata: z.record(z.unknown()).nullable(),
+  createdAt: z.coerce.date(),
+  updatedAt: z.coerce.date(),
+});
+
+export const companySkillListItemSchema = companySkillSchema.extend({
+  attachedAgentCount: z.number().int().nonnegative(),
+});
+
+export const companySkillUsageAgentSchema = z.object({
+  id: z.string().uuid(),
+  name: z.string().min(1),
+  urlKey: z.string().min(1),
+  adapterType: z.string().min(1),
+  desired: z.boolean(),
+  actualState: z.string().nullable(),
+});
+
+export const companySkillDetailSchema = companySkillSchema.extend({
+  attachedAgentCount: z.number().int().nonnegative(),
+  usedByAgents: z.array(companySkillUsageAgentSchema).default([]),
+});
+
+export const companySkillImportSchema = z.object({
+  source: z.string().min(1),
+});
+
+export type CompanySkillImport = z.infer<typeof companySkillImportSchema>;

packages/shared/src/validators/index.ts

@@ -4,6 +4,18 @@ export {
   type CreateCompany,
   type UpdateCompany,
 } from "./company.js";
+export {
+  companySkillSourceTypeSchema,
+  companySkillTrustLevelSchema,
+  companySkillCompatibilitySchema,
+  companySkillFileInventoryEntrySchema,
+  companySkillSchema,
+  companySkillListItemSchema,
+  companySkillUsageAgentSchema,
+  companySkillDetailSchema,
+  companySkillImportSchema,
+  type CompanySkillImport,
+} from "./company-skill.js";
 export {
   agentSkillStateSchema,
   agentSkillSyncModeSchema,