bopodev-api 0.1.34 → 0.1.36

package/src/routes/observability.ts

@@ -25,14 +25,27 @@ import {
   writeAgentOperatingFile
 } from "../services/agent-operating-file-service";
 import { BUILTIN_BOPO_SKILLS } from "../lib/builtin-bopo-skills";
+import {
+  buildKnowledgeTreeFromPaths,
+  createKnowledgeFile,
+  deleteKnowledgeFile,
+  listKnowledgeFiles,
+  readKnowledgeFile,
+  renameKnowledgeFile,
+  renameKnowledgeFolderPrefix,
+  writeKnowledgeFile
+} from "../services/company-knowledge-file-service";
 import {
   createCompanySkillPackage,
+  deleteCompanySkillFile,
   deleteCompanySkillPackage,
   linkCompanySkillFromUrl,
   listCompanySkillFiles,
   listCompanySkillPackages,
   refreshCompanySkillFromUrl,
   readCompanySkillFile,
+  renameCompanySkillFile,
+  setCompanySkillSidebarTitle,
   writeCompanySkillFile
 } from "../services/company-skill-file-service";
 import {
@@ -550,6 +563,7 @@ export function createObservabilityRouter(ctx: AppContext) {
             linkedUrl: pack.linkedUrl,
             linkLastFetchedAt: pack.linkLastFetchedAt,
             hasLocalSkillMd,
+            sidebarTitle: pack.sidebarTitle,
             files: relativePaths.map((relativePath) => ({ relativePath }))
           };
         })
@@ -602,6 +616,77 @@ export function createObservabilityRouter(ctx: AppContext) {
     }
   });
 
+  router.patch("/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() : "";
+    if (!skillId) {
+      return sendError(res, "Query parameter 'skillId' is required.", 422);
+    }
+    const body = req.body as { from?: unknown; to?: unknown };
+    if (typeof body?.from !== "string" || !body.from.trim()) {
+      return sendError(res, "Expected JSON body with string 'from' (current path).", 422);
+    }
+    if (typeof body?.to !== "string" || !body.to.trim()) {
+      return sendError(res, "Expected JSON body with string 'to' (new path).", 422);
+    }
+    try {
+      const result = await renameCompanySkillFile({
+        companyId,
+        skillId,
+        fromRelativePath: body.from.trim(),
+        toRelativePath: body.to.trim()
+      });
+      return sendOk(res, result);
+    } catch (error) {
+      return sendError(res, String(error), 422);
+    }
+  });
+
+  router.patch("/company-skills/sidebar-title", async (req, res) => {
+    if (!enforcePermission(req, res, "agents:write")) {
+      return;
+    }
+    const companyId = req.companyId!;
+    const body = req.body as { skillId?: unknown; title?: unknown };
+    if (typeof body?.skillId !== "string" || !body.skillId.trim()) {
+      return sendError(res, "Expected JSON body with string 'skillId'.", 422);
+    }
+    if (typeof body?.title !== "string") {
+      return sendError(res, "Expected JSON body with string 'title' (empty string resets to skill id).", 422);
+    }
+    try {
+      const result = await setCompanySkillSidebarTitle({
+        companyId,
+        skillId: body.skillId.trim(),
+        title: body.title
+      });
+      return sendOk(res, result);
+    } catch (error) {
+      return sendError(res, String(error), 422);
+    }
+  });
+
+  router.delete("/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);
+    }
+    try {
+      const result = await deleteCompanySkillFile({ companyId, skillId, relativePath });
+      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;
@@ -679,6 +764,143 @@ export function createObservabilityRouter(ctx: AppContext) {
     }
   });
 
+  router.get("/company-knowledge", async (req, res) => {
+    const companyId = req.companyId!;
+    try {
+      const { files } = await listKnowledgeFiles({ companyId });
+      const tree = buildKnowledgeTreeFromPaths(files);
+      return sendOk(res, { items: files, tree });
+    } catch (error) {
+      return sendError(res, String(error), 422);
+    }
+  });
+
+  router.get("/company-knowledge/file", async (req, res) => {
+    const companyId = req.companyId!;
+    const relativePath = typeof req.query.path === "string" ? req.query.path.trim() : "";
+    if (!relativePath) {
+      return sendError(res, "Query parameter 'path' is required.", 422);
+    }
+    try {
+      const file = await readKnowledgeFile({ companyId, relativePath });
+      return sendOk(res, { content: file.content });
+    } catch (error) {
+      return sendError(res, String(error), 422);
+    }
+  });
+
+  router.put("/company-knowledge/file", async (req, res) => {
+    if (!enforcePermission(req, res, "agents:write")) {
+      return;
+    }
+    const companyId = req.companyId!;
+    const relativePath = typeof req.query.path === "string" ? req.query.path.trim() : "";
+    if (!relativePath) {
+      return sendError(res, "Query parameter 'path' is 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 writeKnowledgeFile({
+        companyId,
+        relativePath,
+        content: body.content
+      });
+      return sendOk(res, result);
+    } catch (error) {
+      return sendError(res, String(error), 422);
+    }
+  });
+
+  router.post("/company-knowledge/file", async (req, res) => {
+    if (!enforcePermission(req, res, "agents:write")) {
+      return;
+    }
+    const companyId = req.companyId!;
+    const body = req.body as { path?: unknown; content?: unknown };
+    if (typeof body?.path !== "string" || !body.path.trim()) {
+      return sendError(res, "Expected JSON body with string 'path'.", 422);
+    }
+    const content = typeof body.content === "string" ? body.content : undefined;
+    try {
+      const result = await createKnowledgeFile({
+        companyId,
+        relativePath: body.path.trim(),
+        ...(content !== undefined ? { content } : {})
+      });
+      return sendOk(res, result);
+    } catch (error) {
+      return sendError(res, String(error), 422);
+    }
+  });
+
+  router.patch("/company-knowledge/file", async (req, res) => {
+    if (!enforcePermission(req, res, "agents:write")) {
+      return;
+    }
+    const companyId = req.companyId!;
+    const body = req.body as { from?: unknown; to?: unknown };
+    if (typeof body?.from !== "string" || !body.from.trim()) {
+      return sendError(res, "Expected JSON body with string 'from' (current path).", 422);
+    }
+    if (typeof body?.to !== "string" || !body.to.trim()) {
+      return sendError(res, "Expected JSON body with string 'to' (new path).", 422);
+    }
+    try {
+      const result = await renameKnowledgeFile({
+        companyId,
+        fromRelativePath: body.from.trim(),
+        toRelativePath: body.to.trim()
+      });
+      return sendOk(res, result);
+    } catch (error) {
+      return sendError(res, String(error), 422);
+    }
+  });
+
+  router.patch("/company-knowledge/folder", async (req, res) => {
+    if (!enforcePermission(req, res, "agents:write")) {
+      return;
+    }
+    const companyId = req.companyId!;
+    const body = req.body as { from?: unknown; to?: unknown };
+    if (typeof body?.from !== "string" || !body.from.trim()) {
+      return sendError(res, "Expected JSON body with string 'from' (current folder prefix).", 422);
+    }
+    if (typeof body?.to !== "string" || !body.to.trim()) {
+      return sendError(res, "Expected JSON body with string 'to' (new folder prefix).", 422);
+    }
+    try {
+      const result = await renameKnowledgeFolderPrefix({
+        companyId,
+        fromPrefix: body.from.trim(),
+        toPrefix: body.to.trim()
+      });
+      return sendOk(res, result);
+    } catch (error) {
+      return sendError(res, String(error), 422);
+    }
+  });
+
+  router.delete("/company-knowledge/file", async (req, res) => {
+    if (!enforcePermission(req, res, "agents:write")) {
+      return;
+    }
+    const companyId = req.companyId!;
+    const relativePath = typeof req.query.path === "string" ? req.query.path.trim() : "";
+    if (!relativePath) {
+      return sendError(res, "Query parameter 'path' is required.", 422);
+    }
+    try {
+      const result = await deleteKnowledgeFile({ companyId, relativePath });
+      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;