@axiom-lattice/gateway 2.1.19 → 2.1.21

package/src/routes/index.ts

@@ -1,4 +1,5 @@
 import { FastifyInstance } from "fastify";
+import { ScheduledTaskStatus } from "@axiom-lattice/protocols";
 import * as assistantController from "../controllers/assistant";
 import * as runController from "../controllers/run";
 import * as memoryController from "../controllers/memory";
@@ -9,6 +10,7 @@ import * as schedulesController from "../controllers/schedules";
 import * as configController from "../controllers/config";
 import * as modelsController from "../controllers/models";
 import * as healthController from "../controllers/health";
+import * as skillsController from "../controllers/skills";
 import {
   createRunSchema,
   getAllMemoryItemsSchema,
@@ -200,7 +202,11 @@ export const registerLatticeRoutes = (app: FastifyInstance): void => {
   // Schedule routes for viewing scheduled tasks by thread
   app.get<{
     Params: { assistantId: string; threadId: string };
-    Querystring: { status?: string; limit?: string; offset?: string };
+    Querystring: {
+      status?: ScheduledTaskStatus;
+      limit?: string;
+      offset?: string;
+    };
   }>(
     "/api/assistants/:assistantId/threads/:threadId/schedules",
     schedulesController.getThreadSchedules
@@ -225,4 +231,58 @@ export const registerLatticeRoutes = (app: FastifyInstance): void => {
   app.post<{
     Params: { taskId: string };
   }>("/api/schedules/:taskId/resume", schedulesController.resumeScheduledTask);
+
+  // Skills CRUD routes
+  app.get("/api/skills", skillsController.getSkillList);
+
+  app.get<{
+    Params: { id: string };
+  }>(
+    "/api/skills/:id",
+    skillsController.getSkill
+  );
+
+  app.post<{
+    Body: any;
+  }>(
+    "/api/skills",
+    skillsController.createSkill
+  );
+
+  app.put<{
+    Params: { id: string };
+    Body: any;
+  }>(
+    "/api/skills/:id",
+    skillsController.updateSkill
+  );
+
+  app.delete<{
+    Params: { id: string };
+  }>(
+    "/api/skills/:id",
+    skillsController.deleteSkill
+  );
+
+  // Skills search and filter routes
+  app.get<{
+    Querystring: { key: string; value: string };
+  }>(
+    "/api/skills/search/metadata",
+    skillsController.searchSkillsByMetadata
+  );
+
+  app.get<{
+    Querystring: { compatibility: string };
+  }>(
+    "/api/skills/filter/compatibility",
+    skillsController.filterSkillsByCompatibility
+  );
+
+  app.get<{
+    Querystring: { license: string };
+  }>(
+    "/api/skills/filter/license",
+    skillsController.filterSkillsByLicense
+  );
 };

package/src/schemas/index.ts

@@ -352,3 +352,456 @@ export const getHealthSchema: FastifySchema = {
     },
   },
 };
+
+// Skills Schemas
+export const getSkillListSchema: FastifySchema = {
+  description: "Get list of all skills",
+  tags: ["Skills"],
+  summary: "Get Skill List",
+  response: {
+    200: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" },
+        message: { type: "string" },
+        data: {
+          type: "object",
+          properties: {
+            records: {
+              type: "array",
+              items: { type: "object" },
+            },
+            total: { type: "number" },
+          },
+        },
+      },
+    },
+    500: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" },
+        message: { type: "string" },
+        data: {
+          type: "object",
+          properties: {
+            records: {
+              type: "array",
+              items: { type: "object" },
+            },
+            total: { type: "number" },
+          },
+        },
+      },
+    },
+  },
+};
+
+export const getSkillSchema: FastifySchema = {
+  description: "Get a single skill by ID",
+  tags: ["Skills"],
+  summary: "Get Skill",
+  params: {
+    type: "object",
+    properties: {
+      id: { type: "string", description: "Skill ID" },
+    },
+    required: ["id"],
+  },
+  response: {
+    200: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" },
+        message: { type: "string" },
+        data: { type: "object" },
+      },
+    },
+    404: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" },
+        message: { type: "string" },
+      },
+    },
+    500: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" },
+        message: { type: "string" },
+      },
+    },
+  },
+};
+
+export const createSkillSchema: FastifySchema = {
+  description: "Create a new skill",
+  tags: ["Skills"],
+  summary: "Create Skill",
+  body: {
+    type: "object",
+    properties: {
+      id: { 
+        type: "string", 
+        description: "Skill ID (optional, defaults to name if not provided; must equal name, name is used for path addressing)" 
+      },
+      name: { 
+        type: "string", 
+        description: "Skill name (1-64 chars, lowercase alphanumeric with single hyphens, pattern: ^[a-z0-9]+(-[a-z0-9]+)*$)",
+        pattern: "^[a-z0-9]+(-[a-z0-9]+)*$",
+        minLength: 1,
+        maxLength: 64
+      },
+      description: { type: "string", description: "Skill description" },
+      license: { type: "string", description: "License information" },
+      compatibility: { type: "string", description: "Compatibility information" },
+      metadata: {
+        type: "object",
+        additionalProperties: { type: "string" },
+        description: "Additional metadata",
+      },
+      content: { type: "string", description: "Skill detailed content (markdown)" },
+      subSkills: {
+        type: "array",
+        items: { type: "string" },
+        description: "Array of sub-skill names (hierarchical structure)",
+      },
+    },
+    required: ["name", "description"],
+  },
+  response: {
+    201: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" },
+        message: { type: "string" },
+        data: { type: "object" },
+      },
+    },
+    400: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" },
+        message: { type: "string" },
+      },
+    },
+    409: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" },
+        message: { type: "string" },
+      },
+    },
+    500: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" },
+        message: { type: "string" },
+      },
+    },
+  },
+};
+
+export const updateSkillSchema: FastifySchema = {
+  description: "Update an existing skill",
+  tags: ["Skills"],
+  summary: "Update Skill",
+  params: {
+    type: "object",
+    properties: {
+      id: { type: "string", description: "Skill ID" },
+    },
+    required: ["id"],
+  },
+  body: {
+    type: "object",
+    properties: {
+      name: { 
+        type: "string", 
+        description: "Skill name (1-64 chars, lowercase alphanumeric with single hyphens, pattern: ^[a-z0-9]+(-[a-z0-9]+)*$)",
+        pattern: "^[a-z0-9]+(-[a-z0-9]+)*$",
+        minLength: 1,
+        maxLength: 64
+      },
+      description: { type: "string", description: "Skill description" },
+      license: { type: "string", description: "License information" },
+      compatibility: { type: "string", description: "Compatibility information" },
+      metadata: {
+        type: "object",
+        additionalProperties: { type: "string" },
+        description: "Additional metadata",
+      },
+      content: { type: "string", description: "Skill detailed content (markdown)" },
+      subSkills: {
+        type: "array",
+        items: { type: "string" },
+        description: "Array of sub-skill names (hierarchical structure)",
+      },
+    },
+  },
+  response: {
+    200: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" },
+        message: { type: "string" },
+        data: { type: "object" },
+      },
+    },
+    400: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" },
+        message: { type: "string" },
+      },
+    },
+    404: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" },
+        message: { type: "string" },
+      },
+    },
+    500: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" },
+        message: { type: "string" },
+      },
+    },
+  },
+};
+
+export const deleteSkillSchema: FastifySchema = {
+  description: "Delete a skill by ID",
+  tags: ["Skills"],
+  summary: "Delete Skill",
+  params: {
+    type: "object",
+    properties: {
+      id: { type: "string", description: "Skill ID" },
+    },
+    required: ["id"],
+  },
+  response: {
+    200: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" },
+        message: { type: "string" },
+      },
+    },
+    404: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" },
+        message: { type: "string" },
+      },
+    },
+    500: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" },
+        message: { type: "string" },
+      },
+    },
+  },
+};
+
+export const searchSkillsByMetadataSchema: FastifySchema = {
+  description: "Search skills by metadata",
+  tags: ["Skills"],
+  summary: "Search Skills by Metadata",
+  querystring: {
+    type: "object",
+    properties: {
+      key: { type: "string", description: "Metadata key" },
+      value: { type: "string", description: "Metadata value" },
+    },
+    required: ["key", "value"],
+  },
+  response: {
+    200: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" },
+        message: { type: "string" },
+        data: {
+          type: "object",
+          properties: {
+            records: {
+              type: "array",
+              items: { type: "object" },
+            },
+            total: { type: "number" },
+          },
+        },
+      },
+    },
+    400: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" },
+        message: { type: "string" },
+        data: {
+          type: "object",
+          properties: {
+            records: {
+              type: "array",
+              items: { type: "object" },
+            },
+            total: { type: "number" },
+          },
+        },
+      },
+    },
+    500: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" },
+        message: { type: "string" },
+        data: {
+          type: "object",
+          properties: {
+            records: {
+              type: "array",
+              items: { type: "object" },
+            },
+            total: { type: "number" },
+          },
+        },
+      },
+    },
+  },
+};
+
+export const filterSkillsByCompatibilitySchema: FastifySchema = {
+  description: "Filter skills by compatibility",
+  tags: ["Skills"],
+  summary: "Filter Skills by Compatibility",
+  querystring: {
+    type: "object",
+    properties: {
+      compatibility: { type: "string", description: "Compatibility string" },
+    },
+    required: ["compatibility"],
+  },
+  response: {
+    200: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" },
+        message: { type: "string" },
+        data: {
+          type: "object",
+          properties: {
+            records: {
+              type: "array",
+              items: { type: "object" },
+            },
+            total: { type: "number" },
+          },
+        },
+      },
+    },
+    400: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" },
+        message: { type: "string" },
+        data: {
+          type: "object",
+          properties: {
+            records: {
+              type: "array",
+              items: { type: "object" },
+            },
+            total: { type: "number" },
+          },
+        },
+      },
+    },
+    500: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" },
+        message: { type: "string" },
+        data: {
+          type: "object",
+          properties: {
+            records: {
+              type: "array",
+              items: { type: "object" },
+            },
+            total: { type: "number" },
+          },
+        },
+      },
+    },
+  },
+};
+
+export const filterSkillsByLicenseSchema: FastifySchema = {
+  description: "Filter skills by license",
+  tags: ["Skills"],
+  summary: "Filter Skills by License",
+  querystring: {
+    type: "object",
+    properties: {
+      license: { type: "string", description: "License string" },
+    },
+    required: ["license"],
+  },
+  response: {
+    200: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" },
+        message: { type: "string" },
+        data: {
+          type: "object",
+          properties: {
+            records: {
+              type: "array",
+              items: { type: "object" },
+            },
+            total: { type: "number" },
+          },
+        },
+      },
+    },
+    400: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" },
+        message: { type: "string" },
+        data: {
+          type: "object",
+          properties: {
+            records: {
+              type: "array",
+              items: { type: "object" },
+            },
+            total: { type: "number" },
+          },
+        },
+      },
+    },
+    500: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" },
+        message: { type: "string" },
+        data: {
+          type: "object",
+          properties: {
+            records: {
+              type: "array",
+              items: { type: "object" },
+            },
+            total: { type: "number" },
+          },
+        },
+      },
+    },
+  },
+};