bopodev-api 0.1.12 → 0.1.14

package/src/services/governance-service.ts

@@ -10,24 +10,31 @@ import {
   createIssue,
   createProject,
   goals,
+  listAgents,
   listIssues,
   listProjects,
-  projects
+  projects,
+  updatePluginConfig
 } from "bopodev-db";
 import {
   normalizeRuntimeConfig,
+  resolveRuntimeModelForProvider,
   requiresRuntimeCwd,
   runtimeConfigToDb,
   runtimeConfigToStateBlobPatch
 } from "../lib/agent-config";
+import { resolveOpencodeRuntimeModel } from "../lib/opencode-model";
 import { hasText, resolveDefaultRuntimeCwdForCompany } from "../lib/workspace-policy";
+import { appendDurableFact } from "./memory-file-service";
 
 const approvalGatedActions = new Set([
   "hire_agent",
   "activate_goal",
   "override_budget",
   "pause_agent",
-  "terminate_agent"
+  "terminate_agent",
+  "promote_memory_fact",
+  "grant_plugin_capabilities"
 ]);
 
 const hireAgentPayloadSchema = AgentCreateRequestSchema.extend({
@@ -56,6 +63,18 @@ const activateGoalPayloadSchema = z.object({
   title: z.string().min(1),
   description: z.string().optional()
 });
+const promoteMemoryFactPayloadSchema = z.object({
+  agentId: z.string().min(1),
+  fact: z.string().min(1),
+  sourceRunId: z.string().optional()
+});
+const grantPluginCapabilitiesPayloadSchema = z.object({
+  pluginId: z.string().min(1),
+  enabled: z.boolean().optional(),
+  priority: z.number().int().min(0).max(1000).optional(),
+  grantedCapabilities: z.array(z.string().min(1)).default([]),
+  config: z.record(z.string(), z.unknown()).default({})
+});
 const AGENT_STARTUP_PROJECT_NAME = "Agent Onboarding";
 const AGENT_STARTUP_TASK_MARKER = "[bopodev:onboarding:agent-startup:v1]";
 
@@ -102,7 +121,7 @@ export async function resolveApproval(
     let execution:
       | {
           applied: boolean;
-          entityType?: "agent" | "goal";
+          entityType?: "agent" | "goal" | "memory";
           entityId?: string;
           entity?: Record<string, unknown>;
         }
@@ -176,12 +195,32 @@ async function applyApprovalAction(db: BopoDb, companyId: string, action: string
       },
       defaultRuntimeCwd
     });
+    runtimeConfig.runtimeModel = await resolveOpencodeRuntimeModel(parsed.data.providerType, runtimeConfig);
+    runtimeConfig.runtimeModel = resolveRuntimeModelForProvider(parsed.data.providerType, runtimeConfig.runtimeModel);
+    if (providerRequiresNamedModel(parsed.data.providerType) && !hasText(runtimeConfig.runtimeModel)) {
+      throw new GovernanceError("Approval payload for agent hiring must include a named runtime model.");
+    }
     if (requiresRuntimeCwd(parsed.data.providerType) && !hasText(runtimeConfig.runtimeCwd)) {
       throw new GovernanceError("Approval payload for agent hiring is missing runtime working directory.");
     }
     if (requiresRuntimeCwd(parsed.data.providerType) && hasText(runtimeConfig.runtimeCwd)) {
       await mkdir(runtimeConfig.runtimeCwd!, { recursive: true });
     }
+    const existingAgents = await listAgents(db, companyId);
+    const duplicate = existingAgents.find(
+      (agent) =>
+        agent.role === parsed.data.role &&
+        (agent.managerAgentId ?? null) === (parsed.data.managerAgentId ?? null) &&
+        agent.status !== "terminated"
+    );
+    if (duplicate) {
+      return {
+        applied: false,
+        entityType: "agent" as const,
+        entityId: duplicate.id,
+        entity: duplicate as unknown as Record<string, unknown>
+      };
+    }
 
     const agent = await createAgent(db, {
       companyId,
@@ -196,7 +235,7 @@ async function applyApprovalAction(db: BopoDb, companyId: string, action: string
       initialState: runtimeConfigToStateBlobPatch(runtimeConfig)
     });
     const startupProjectId = await ensureAgentStartupProject(db, companyId);
-    await ensureAgentStartupIssue(db, companyId, startupProjectId, agent.id, agent.role, agent.name);
+    await ensureAgentStartupIssue(db, companyId, startupProjectId, agent.id, agent.role);
 
     return {
       applied: true,
@@ -262,9 +301,62 @@ async function applyApprovalAction(db: BopoDb, companyId: string, action: string
     return { applied: false };
   }
 
+  if (action === "promote_memory_fact") {
+    const parsed = promoteMemoryFactPayloadSchema.safeParse(payload);
+    if (!parsed.success) {
+      throw new GovernanceError("Approval payload for memory promotion is invalid.");
+    }
+    const targetFile = await appendDurableFact({
+      companyId,
+      agentId: parsed.data.agentId,
+      fact: parsed.data.fact,
+      sourceRunId: parsed.data.sourceRunId ?? null
+    });
+    return {
+      applied: Boolean(targetFile),
+      entityType: "memory" as const,
+      entityId: parsed.data.agentId,
+      entity: {
+        agentId: parsed.data.agentId,
+        sourceRunId: parsed.data.sourceRunId ?? null,
+        fact: parsed.data.fact,
+        targetFile
+      }
+    };
+  }
+  if (action === "grant_plugin_capabilities") {
+    const parsed = grantPluginCapabilitiesPayloadSchema.safeParse(payload);
+    if (!parsed.success) {
+      throw new GovernanceError("Approval payload for plugin capability grant is invalid.");
+    }
+    await updatePluginConfig(db, {
+      companyId,
+      pluginId: parsed.data.pluginId,
+      enabled: parsed.data.enabled,
+      priority: parsed.data.priority,
+      grantedCapabilitiesJson: JSON.stringify(parsed.data.grantedCapabilities),
+      configJson: JSON.stringify(parsed.data.config)
+    });
+    return {
+      applied: true,
+      entityType: "memory" as const,
+      entityId: parsed.data.pluginId,
+      entity: {
+        pluginId: parsed.data.pluginId,
+        enabled: parsed.data.enabled ?? null,
+        priority: parsed.data.priority ?? null,
+        grantedCapabilities: parsed.data.grantedCapabilities
+      }
+    };
+  }
+
   throw new GovernanceError(`Unsupported approval action: ${action}`);
 }
 
+function providerRequiresNamedModel(providerType: string) {
+  return providerType !== "http" && providerType !== "shell";
+}
+
 function parsePayload(payloadJson: string) {
   try {
     const parsed = JSON.parse(payloadJson) as unknown;
@@ -293,11 +385,10 @@ async function ensureAgentStartupIssue(
   companyId: string,
   projectId: string,
   agentId: string,
-  role: string,
-  name: string
+  role: string
 ) {
   const title = `Set up ${role} operating files`;
-  const body = buildAgentStartupTaskBody(name, agentId);
+  const body = buildAgentStartupTaskBody(agentId);
   const existingIssues = await listIssues(db, companyId);
   const existing = existingIssues.find(
     (issue) =>
@@ -323,20 +414,20 @@ async function ensureAgentStartupIssue(
   return created.id;
 }
 
-function buildAgentStartupTaskBody(agentName: string, agentId: string) {
-  const slug = slugifyAgentPath(agentName || agentId);
+function buildAgentStartupTaskBody(agentId: string) {
+  const agentFolder = `agents/${agentId}`;
   return [
     AGENT_STARTUP_TASK_MARKER,
     "",
     `Create your operating baseline before starting feature delivery work.`,
     "",
-    `1. Create the folder \`agents/${slug}/\` in the repository workspace.`,
+    `1. Create the folder \`${agentFolder}/\` in the repository workspace.`,
     "2. Author these files with your own responsibilities and working style:",
-    `   - \`agents/${slug}/AGENTS.md\``,
-    `   - \`agents/${slug}/HEARTBEAT.md\``,
-    `   - \`agents/${slug}/SOUL.md\``,
-    `   - \`agents/${slug}/TOOLS.md\``,
-    `3. Update your own agent runtime config via \`PUT /agents/:agentId\` and set \`runtimeConfig.bootstrapPrompt\` to reference \`agents/${slug}/AGENTS.md\` as your primary guide.`,
+    `   - \`${agentFolder}/AGENTS.md\``,
+    `   - \`${agentFolder}/HEARTBEAT.md\``,
+    `   - \`${agentFolder}/SOUL.md\``,
+    `   - \`${agentFolder}/TOOLS.md\``,
+    `3. Update your own agent runtime config via \`PUT /agents/:agentId\` and set \`runtimeConfig.bootstrapPrompt\` to reference \`${agentFolder}/AGENTS.md\` as your primary guide.`,
     "4. Post an issue comment summarizing completed setup artifacts.",
     "",
     "Safety checks:",
@@ -345,11 +436,3 @@ function buildAgentStartupTaskBody(agentName: string, agentId: string) {
   ].join("\n");
 }
 
-function slugifyAgentPath(value: string) {
-  const base = value
-    .toLowerCase()
-    .replace(/[^a-z0-9]+/g, "-")
-    .replace(/^-+|-+$/g, "");
-  return base || "agent";
-}
-