refactor(api): split routes and system boundaries

.dependency-cruiser.cjs

@@ -19,12 +19,48 @@ module.exports = {
       from: { path: "^apps/api-ts/src/lib/" },
       to: { path: "^apps/api-ts/src/app/" },
     },
+    {
+      name: "platform-must-not-import-domains",
+      severity: "error",
+      from: { path: "^apps/api-ts/src/platform/" },
+      to: { path: "^apps/api-ts/src/domains/" },
+    },
+    {
+      name: "platform-must-not-import-app",
+      severity: "error",
+      from: { path: "^apps/api-ts/src/platform/" },
+      to: { path: "^apps/api-ts/src/app/" },
+    },
     {
       name: "provider-services-must-not-import-app",
       severity: "error",
       from: { path: "^apps/api-ts/src/domains/providers/services/" },
       to: { path: "^apps/api-ts/src/app/" },
     },
+    {
+      name: "provider-services-must-not-import-provider-adapters-directly",
+      severity: "error",
+      from: {
+        path: "^apps/api-ts/src/domains/providers/services/",
+        pathNot: "\\.test\\.ts$",
+      },
+      to: { path: "^apps/api-ts/src/domains/providers/adapters/" },
+    },
+    {
+      name: "provider-adapters-must-not-import-provider-services",
+      severity: "error",
+      from: {
+        path: "^apps/api-ts/src/domains/providers/adapters/",
+        pathNot: "\\.test\\.ts$",
+      },
+      to: { path: "^apps/api-ts/src/domains/providers/services/" },
+    },
+    {
+      name: "provider-adapters-must-not-import-app",
+      severity: "error",
+      from: { path: "^apps/api-ts/src/domains/providers/adapters/" },
+      to: { path: "^apps/api-ts/src/app/" },
+    },
     {
       name: "providers-must-not-import-threads-domain",
       severity: "error",

apps/api-ts/src/app/create-server.ts

@@ -36,9 +36,9 @@ import {
   invalidateProviderSearchCaches,
 } from "../domains/providers/search.js";
 import {
-  registerPlatformRoutes,
+  registerSystemRoutes,
   type ProxyRequest,
-} from "./routes/platform/index.js";
+} from "./routes/system/index.js";
 import { registerThreadRoutes } from "./routes/threads/index.js";
 import { registerProviderRoutes } from "./routes/providers/index.js";
 
@@ -244,7 +244,7 @@ export async function createServer(): Promise<FastifyInstance> {
   });
   app.addHook("preHandler", requireApiTokenForProtectedLocalActions);
 
-  await registerPlatformRoutes(app, {
+  await registerSystemRoutes(app, {
     getAgentRuntimeState,
     getCachedDataSources,
   });

apps/api-ts/src/app/routes/providers/actions.ts

@@ -0,0 +1,40 @@
+import type { FastifyInstance } from "fastify";
+import { runProviderSessionAction } from "../../../domains/providers/index.js";
+import {
+  envelope,
+  withSchemaVersion,
+} from "../../../lib/utils.js";
+import { providerSessionActionSchema } from "./schemas.js";
+
+export function registerProviderActionRoutes(app: FastifyInstance): void {
+  app.post<{ Body: unknown }>(
+    "/api/provider-session-action",
+    async (req, reply) => {
+      const parsed = providerSessionActionSchema.safeParse(req.body);
+      if (!parsed.success) {
+        return reply.code(400).send(envelope(null, parsed.error.message));
+      }
+      try {
+        const result = await runProviderSessionAction(
+          parsed.data.provider,
+          parsed.data.action,
+          parsed.data.file_paths,
+          parsed.data.dry_run,
+          parsed.data.confirm_token,
+          {
+            backup_before_delete: parsed.data.backup_before_delete,
+            backup_root: parsed.data.backup_root,
+          },
+        );
+        const status = result.ok ? 200 : 400;
+        return reply.code(status).send(withSchemaVersion(result));
+      } catch (error) {
+        return reply
+          .code(500)
+          .send(
+            envelope(null, `provider-session-action-error: ${String(error)}`),
+          );
+      }
+    },
+  );
+}