bopodev-api 0.1.32 → 0.1.33

package/src/routes/observability.ts

@@ -24,6 +24,17 @@ import {
   readAgentOperatingFile,
   writeAgentOperatingFile
 } from "../services/agent-operating-file-service";
+import { BUILTIN_BOPO_SKILLS } from "../lib/builtin-bopo-skills";
+import {
+  createCompanySkillPackage,
+  deleteCompanySkillPackage,
+  linkCompanySkillFromUrl,
+  listCompanySkillFiles,
+  listCompanySkillPackages,
+  refreshCompanySkillFromUrl,
+  readCompanySkillFile,
+  writeCompanySkillFile
+} from "../services/company-skill-file-service";
 import {
   listAgentMemoryFiles,
   listCompanyMemoryFiles,
@@ -512,6 +523,162 @@ export function createObservabilityRouter(ctx: AppContext) {
     }
   });
 
+  router.get("/builtin-skills", async (_req, res) => {
+    return sendOk(
+      res,
+      BUILTIN_BOPO_SKILLS.map((row) => ({
+        id: row.id,
+        title: row.title,
+        content: row.content
+      }))
+    );
+  });
+
+  router.get("/company-skills", async (req, res) => {
+    const companyId = req.companyId!;
+    try {
+      const { items: packages } = await listCompanySkillPackages({ companyId, maxSkills: 80 });
+      const items = await Promise.all(
+        packages.map(async (pack) => {
+          const { relativePaths, hasLocalSkillMd } = await listCompanySkillFiles({
+            companyId,
+            skillId: pack.skillId,
+            maxFiles: 200
+          });
+          return {
+            skillId: pack.skillId,
+            linkedUrl: pack.linkedUrl,
+            linkLastFetchedAt: pack.linkLastFetchedAt,
+            hasLocalSkillMd,
+            files: relativePaths.map((relativePath) => ({ relativePath }))
+          };
+        })
+      );
+      return sendOk(res, { items });
+    } catch (error) {
+      return sendError(res, String(error), 422);
+    }
+  });
+
+  router.get("/company-skills/file", async (req, res) => {
+    const companyId = req.companyId!;
+    const skillId = typeof req.query.skillId === "string" ? req.query.skillId.trim() : "";
+    const relativePath = typeof req.query.path === "string" ? req.query.path.trim() : "";
+    if (!skillId || !relativePath) {
+      return sendError(res, "Query parameters 'skillId' and 'path' are required.", 422);
+    }
+    try {
+      const file = await readCompanySkillFile({ companyId, skillId, relativePath });
+      return sendOk(res, { content: file.content });
+    } catch (error) {
+      return sendError(res, String(error), 422);
+    }
+  });
+
+  router.put("/company-skills/file", async (req, res) => {
+    if (!enforcePermission(req, res, "agents:write")) {
+      return;
+    }
+    const companyId = req.companyId!;
+    const skillId = typeof req.query.skillId === "string" ? req.query.skillId.trim() : "";
+    const relativePath = typeof req.query.path === "string" ? req.query.path.trim() : "";
+    if (!skillId || !relativePath) {
+      return sendError(res, "Query parameters 'skillId' and 'path' are required.", 422);
+    }
+    const body = req.body as { content?: unknown };
+    if (typeof body?.content !== "string") {
+      return sendError(res, "Expected JSON body with string 'content'.", 422);
+    }
+    try {
+      const result = await writeCompanySkillFile({
+        companyId,
+        skillId,
+        relativePath,
+        content: body.content
+      });
+      return sendOk(res, result);
+    } catch (error) {
+      return sendError(res, String(error), 422);
+    }
+  });
+
+  router.post("/company-skills/create", async (req, res) => {
+    if (!enforcePermission(req, res, "agents:write")) {
+      return;
+    }
+    const companyId = req.companyId!;
+    const body = req.body as { skillId?: unknown };
+    if (typeof body?.skillId !== "string" || !body.skillId.trim()) {
+      return sendError(res, "Expected JSON body with string 'skillId'.", 422);
+    }
+    try {
+      const result = await createCompanySkillPackage({ companyId, skillId: body.skillId });
+      return sendOk(res, result);
+    } catch (error) {
+      return sendError(res, String(error), 422);
+    }
+  });
+
+  router.post("/company-skills/link-url", async (req, res) => {
+    if (!enforcePermission(req, res, "agents:write")) {
+      return;
+    }
+    const companyId = req.companyId!;
+    const body = req.body as { url?: unknown; skillId?: unknown };
+    if (typeof body?.url !== "string" || !body.url.trim()) {
+      return sendError(res, "Expected JSON body with string 'url'.", 422);
+    }
+    const optionalSkillId =
+      typeof body.skillId === "string" && body.skillId.trim() ? body.skillId.trim() : undefined;
+    try {
+      const result = await linkCompanySkillFromUrl({
+        companyId,
+        url: body.url,
+        ...(optionalSkillId ? { skillId: optionalSkillId } : {})
+      });
+      return sendOk(res, result);
+    } catch (error) {
+      return sendError(res, String(error), 422);
+    }
+  });
+
+  router.post("/company-skills/refresh-from-url", async (req, res) => {
+    if (!enforcePermission(req, res, "agents:write")) {
+      return;
+    }
+    const companyId = req.companyId!;
+    const body = req.body as { skillId?: unknown };
+    if (typeof body?.skillId !== "string" || !body.skillId.trim()) {
+      return sendError(res, "Expected JSON body with string 'skillId'.", 422);
+    }
+    try {
+      const result = await refreshCompanySkillFromUrl({
+        companyId,
+        skillId: body.skillId.trim()
+      });
+      return sendOk(res, result);
+    } catch (error) {
+      return sendError(res, String(error), 422);
+    }
+  });
+
+  router.delete("/company-skills", async (req, res) => {
+    if (!enforcePermission(req, res, "agents:write")) {
+      return;
+    }
+    const companyId = req.companyId!;
+    const skillId = typeof req.query.skillId === "string" ? req.query.skillId.trim() : "";
+    if (!skillId) {
+      return sendError(res, "Query parameter 'skillId' is required.", 422);
+    }
+    try {
+      const result = await deleteCompanySkillPackage({ companyId, skillId });
+      return sendOk(res, result);
+    } catch (error) {
+      return sendError(res, String(error), 422);
+    }
+  });
+
   router.get("/memory/:agentId/context-preview", async (req, res) => {
     const companyId = req.companyId!;
     const agentId = req.params.agentId;

package/src/services/company-file-archive-service.ts

@@ -10,6 +10,7 @@ import {
   resolveAgentOperatingPath,
   resolveCompanyProjectsWorkspacePath
 } from "../lib/instance-paths";
+import { SKILL_LINK_BASENAME } from "./company-skill-file-service";
 import { listWorkLoopTriggers, listWorkLoops } from "./work-loop-service/work-loop-service";
 
 const EXPORT_SCHEMA = "bopo/company-export/v1";
@@ -68,7 +69,7 @@ async function walkTextFilesUnder(rootAbs: string, budget: { n: number }): Promi
         return;
       }
       const name = ent.name;
-      if (name.startsWith(".")) {
+      if (name.startsWith(".") && name !== SKILL_LINK_BASENAME) {
         continue;
       }
       const full = join(dir, name);