bopodev-api 0.1.29 → 0.1.30

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bopodev-api",
-  "version": "0.1.29",
+  "version": "0.1.30",
   "license": "MIT",
   "type": "module",
   "files": [
@@ -17,9 +17,9 @@
     "nanoid": "^5.1.5",
     "ws": "^8.19.0",
     "zod": "^4.1.5",
-    "bopodev-contracts": "0.1.29",
-    "bopodev-agent-sdk": "0.1.29",
-    "bopodev-db": "0.1.29"
+    "bopodev-contracts": "0.1.30",
+    "bopodev-db": "0.1.30",
+    "bopodev-agent-sdk": "0.1.30"
   },
   "devDependencies": {
     "@types/cors": "^2.8.19",

package/src/lib/ceo-bootstrap-prompt.ts

@@ -5,6 +5,7 @@ export function buildDefaultCeoBootstrapPrompt() {
     "- Clarify missing constraints before hiring when requirements are ambiguous.",
     "- Choose reporting lines, provider, model, and permissions that fit company goals and budget.",
     "- Use governance-safe hiring via `POST /agents` with `requestApproval: true` unless explicitly told otherwise.",
+    "- Always set `capabilities` on every new hire: one or two sentences describing what they do, for the org chart and team roster (delegation). If the issue metadata or body specifies requested capabilities, use or refine that text; if missing, write an appropriate line from the role and request details.",
     "- Avoid duplicate hires by checking existing agents and pending approvals first.",
     "- Use the control-plane coordination skill as the source of truth for endpoint paths, required headers, and approval workflow steps.",
     "- Record hiring rationale and key decisions in issue comments for auditability."

package/src/realtime/office-space.ts

@@ -437,6 +437,7 @@ function normalizeProviderType(value: string): OfficeOccupant["providerType"] {
     value === "gemini_cli" ||
     value === "openai_api" ||
     value === "anthropic_api" ||
+    value === "openclaw_gateway" ||
     value === "http" ||
     value === "shell"
     ? value

package/src/routes/agents.ts

@@ -1,4 +1,4 @@
-import { Router } from "express";
+import { Router, type Response } from "express";
 import { mkdir } from "node:fs/promises";
 import { z } from "zod";
 import {
@@ -82,17 +82,25 @@ const runtimePreflightSchema = z.object({
     "gemini_cli",
     "openai_api",
     "anthropic_api",
+    "openclaw_gateway",
     "http",
     "shell"
   ]),
   runtimeConfig: z.record(z.string(), z.unknown()).optional(),
   ...legacyRuntimeConfigSchema.shape
 });
+
+/** Body for POST /agents/adapter-models/:providerType (runtime for CLI discovery). */
+const adapterModelsBodySchema = z.object({
+  runtimeConfig: z.record(z.string(), z.unknown()).optional(),
+  ...legacyRuntimeConfigSchema.shape
+});
 const UPDATE_AGENT_ALLOWED_KEYS = new Set([
   "managerAgentId",
   "role",
   "roleKey",
   "title",
+  "capabilities",
   "name",
   "providerType",
   "status",
@@ -135,7 +143,7 @@ function toAgentResponse(agent: Record<string, unknown>) {
 }
 
 function providerRequiresNamedModel(providerType: string) {
-  return providerType !== "http" && providerType !== "shell";
+  return providerType !== "http" && providerType !== "shell" && providerType !== "openclaw_gateway";
 }
 
 const agentResponseSchema = AgentSchema.extend({
@@ -149,6 +157,66 @@ function ensureNamedRuntimeModel(providerType: string, runtimeModel: string | un
   return hasText(runtimeModel);
 }
 
+type AdapterModelsProviderType = NonNullable<z.infer<typeof runtimePreflightSchema>["providerType"]>;
+
+async function handleAdapterModelsRequest(
+  ctx: AppContext,
+  res: Response,
+  companyId: string,
+  providerType: string,
+  parsedBody: z.infer<typeof adapterModelsBodySchema> | null
+) {
+  if (!runtimePreflightSchema.shape.providerType.safeParse(providerType).success) {
+    return sendError(res, `Unsupported provider type: ${providerType}`, 422);
+  }
+  const defaultRuntimeCwd = await resolveDefaultRuntimeCwdForCompany(ctx.db, companyId);
+  let runtimeConfig: ReturnType<typeof normalizeRuntimeConfig>;
+  try {
+    if (parsedBody) {
+      runtimeConfig = normalizeRuntimeConfig({
+        runtimeConfig: parsedBody.runtimeConfig,
+        legacy: {
+          runtimeCommand: parsedBody.runtimeCommand,
+          runtimeArgs: parsedBody.runtimeArgs,
+          runtimeCwd: parsedBody.runtimeCwd,
+          runtimeTimeoutMs: parsedBody.runtimeTimeoutMs,
+          runtimeModel: parsedBody.runtimeModel,
+          runtimeThinkingEffort: parsedBody.runtimeThinkingEffort,
+          bootstrapPrompt: parsedBody.bootstrapPrompt,
+          runtimeTimeoutSec: parsedBody.runtimeTimeoutSec,
+          interruptGraceSec: parsedBody.interruptGraceSec,
+          runtimeEnv: parsedBody.runtimeEnv,
+          runPolicy: parsedBody.runPolicy
+        },
+        defaultRuntimeCwd
+      });
+    } else {
+      runtimeConfig = normalizeRuntimeConfig({ defaultRuntimeCwd });
+    }
+    runtimeConfig = enforceRuntimeCwdPolicy(companyId, runtimeConfig);
+  } catch (error) {
+    return sendError(res, String(error), 422);
+  }
+
+  if (parsedBody && runtimeConfig.runtimeCwd) {
+    await mkdir(runtimeConfig.runtimeCwd, { recursive: true });
+  }
+
+  const typedProviderType = providerType as AdapterModelsProviderType;
+  const models = await getAdapterModels(typedProviderType, {
+    command: runtimeConfig.runtimeCommand,
+    args: runtimeConfig.runtimeArgs,
+    cwd: runtimeConfig.runtimeCwd,
+    env: runtimeConfig.runtimeEnv,
+    model: runtimeConfig.runtimeModel,
+    thinkingEffort: runtimeConfig.runtimeThinkingEffort,
+    timeoutMs: runtimeConfig.runtimeTimeoutSec > 0 ? runtimeConfig.runtimeTimeoutSec * 1000 : undefined,
+    interruptGraceSec: runtimeConfig.interruptGraceSec,
+    runPolicy: runtimeConfig.runPolicy
+  });
+  return sendOk(res, { providerType: typedProviderType, models });
+}
+
 export function createAgentsRouter(ctx: AppContext) {
   const router = Router();
   router.use(requireCompanyScope);
@@ -229,42 +297,16 @@ export function createAgentsRouter(ctx: AppContext) {
 
   router.get("/adapter-models/:providerType", async (req, res) => {
     const providerType = req.params.providerType;
-    if (!runtimePreflightSchema.shape.providerType.safeParse(providerType).success) {
-      return sendError(res, `Unsupported provider type: ${providerType}`, 422);
-    }
-    const defaultRuntimeCwd = await resolveDefaultRuntimeCwdForCompany(ctx.db, req.companyId!);
-    let runtimeConfig: ReturnType<typeof normalizeRuntimeConfig>;
-    try {
-      runtimeConfig = normalizeRuntimeConfig({
-        runtimeConfig: req.body?.runtimeConfig,
-        defaultRuntimeCwd
-      });
-      runtimeConfig = enforceRuntimeCwdPolicy(req.companyId!, runtimeConfig);
-    } catch (error) {
-      return sendError(res, String(error), 422);
+    return handleAdapterModelsRequest(ctx, res, req.companyId!, providerType, null);
+  });
+
+  router.post("/adapter-models/:providerType", async (req, res) => {
+    const providerType = req.params.providerType;
+    const parsed = adapterModelsBodySchema.safeParse(req.body ?? {});
+    if (!parsed.success) {
+      return sendError(res, parsed.error.message, 422);
     }
-    const typedProviderType = providerType as
-      | "claude_code"
-      | "codex"
-      | "cursor"
-      | "opencode"
-      | "gemini_cli"
-      | "openai_api"
-      | "anthropic_api"
-      | "http"
-      | "shell";
-    const models = await getAdapterModels(typedProviderType, {
-      command: runtimeConfig.runtimeCommand,
-      args: runtimeConfig.runtimeArgs,
-      cwd: runtimeConfig.runtimeCwd,
-      env: runtimeConfig.runtimeEnv,
-      model: runtimeConfig.runtimeModel,
-      thinkingEffort: runtimeConfig.runtimeThinkingEffort,
-      timeoutMs: runtimeConfig.runtimeTimeoutSec > 0 ? runtimeConfig.runtimeTimeoutSec * 1000 : undefined,
-      interruptGraceSec: runtimeConfig.interruptGraceSec,
-      runPolicy: runtimeConfig.runPolicy
-    });
-    return sendOk(res, { providerType: typedProviderType, models });
+    return handleAdapterModelsRequest(ctx, res, req.companyId!, providerType, parsed.data);
   });
 
   router.post("/runtime-preflight", async (req, res) => {
@@ -425,6 +467,7 @@ export function createAgentsRouter(ctx: AppContext) {
       role: resolveAgentRoleText(parsed.data.role, parsed.data.roleKey, parsed.data.title),
       roleKey: normalizeRoleKey(parsed.data.roleKey),
       title: normalizeTitle(parsed.data.title),
+      capabilities: normalizeCapabilities(parsed.data.capabilities),
       name: parsed.data.name,
       providerType: parsed.data.providerType,
       heartbeatCron: parsed.data.heartbeatCron,
@@ -573,6 +616,8 @@ export function createAgentsRouter(ctx: AppContext) {
             : undefined,
         roleKey: parsed.data.roleKey !== undefined ? normalizeRoleKey(parsed.data.roleKey) : undefined,
         title: parsed.data.title !== undefined ? normalizeTitle(parsed.data.title) : undefined,
+        capabilities:
+          parsed.data.capabilities !== undefined ? normalizeCapabilities(parsed.data.capabilities) : undefined,
         name: parsed.data.name,
         providerType: parsed.data.providerType,
         status: parsed.data.status,
@@ -823,6 +868,11 @@ function normalizeTitle(input: string | null | undefined) {
   return normalized ? normalized : null;
 }
 
+function normalizeCapabilities(input: string | null | undefined) {
+  const normalized = input?.trim();
+  return normalized ? normalized : null;
+}
+
 function resolveAgentRoleText(
   legacyRole: string | undefined,
   roleKeyInput: string | null | undefined,

package/src/routes/companies.ts

@@ -114,6 +114,8 @@ export function createCompaniesRouter(ctx: AppContext) {
       role: "CEO",
       roleKey: "ceo",
       title: "CEO",
+      capabilities:
+        "Company leadership: priorities, hiring, governance, and aligning agents to mission and budget.",
       name: "CEO",
       providerType,
       heartbeatCron: "*/5 * * * *",

package/src/routes/issues.ts

@@ -612,10 +612,13 @@ function applyIssueMetadataToBody(
         delegatedHiringIntent?: {
           intentType: "agent_hiring_request";
           requestedRole?: string | null;
+          requestedRoleKey?: string | null;
+          requestedTitle?: string | null;
           requestedName?: string | null;
           requestedManagerAgentId?: string | null;
           requestedProviderType?: string | null;
           requestedRuntimeModel?: string | null;
+          requestedCapabilities?: string | null;
         };
       }
     | undefined

package/src/scripts/onboard-seed.ts

@@ -50,7 +50,16 @@ const DEFAULT_COMPANY_ID_ENV = "BOPO_DEFAULT_COMPANY_ID";
 const DEFAULT_AGENT_PROVIDER_ENV = "BOPO_DEFAULT_AGENT_PROVIDER";
 const DEFAULT_AGENT_MODEL_ENV = "BOPO_DEFAULT_AGENT_MODEL";
 const DEFAULT_TEMPLATE_ENV = "BOPO_DEFAULT_TEMPLATE_ID";
-type AgentProvider = "codex" | "claude_code" | "cursor" | "gemini_cli" | "opencode" | "openai_api" | "anthropic_api" | "shell";
+type AgentProvider =
+  | "codex"
+  | "claude_code"
+  | "cursor"
+  | "gemini_cli"
+  | "opencode"
+  | "openai_api"
+  | "anthropic_api"
+  | "openclaw_gateway"
+  | "shell";
 const CEO_BOOTSTRAP_SUMMARY = "ceo bootstrap heartbeat";
 const STARTUP_PROJECT_NAME = "Leadership Setup";
 const CEO_STARTUP_TASK_TITLE = "Set up CEO operating files and hire founding engineer";
@@ -130,6 +139,8 @@ export async function ensureOnboardingSeed(input: {
           role: "CEO",
           roleKey: "ceo",
           title: "CEO",
+          capabilities:
+            "Company leadership: priorities, hiring, governance, and aligning agents to mission and budget.",
           name: "CEO",
           providerType: agentProvider,
           heartbeatCron: "*/5 * * * *",
@@ -399,6 +410,7 @@ function parseAgentProvider(value: unknown): AgentProvider | null {
     value === "opencode" ||
     value === "openai_api" ||
     value === "anthropic_api" ||
+    value === "openclaw_gateway" ||
     value === "shell"
   ) {
     return value;

package/src/services/governance-service.ts

@@ -60,19 +60,6 @@ const approvalGatedActions = new Set([
 const hireAgentPayloadSchema = AgentCreateRequestSchema.extend({
   sourceIssueId: z.string().min(1).optional(),
   sourceIssueIds: z.array(z.string().min(1)).default([]),
-  delegationIntent: z
-    .object({
-      intentType: z.literal("agent_hiring_request"),
-      requestedRole: z.string().nullable().optional(),
-      requestedName: z.string().nullable().optional(),
-      requestedManagerAgentId: z.string().nullable().optional(),
-      requestedProviderType: z
-        .enum(["claude_code", "codex", "cursor", "opencode", "gemini_cli", "openai_api", "anthropic_api", "http", "shell"])
-        .nullable()
-        .optional(),
-      requestedRuntimeModel: z.string().nullable().optional()
-    })
-    .optional(),
   runtimeCommand: z.string().optional(),
   runtimeArgs: z.array(z.string()).optional(),
   runtimeCwd: z.string().optional(),
@@ -310,6 +297,7 @@ async function applyApprovalAction(db: BopoDb, companyId: string, action: string
       role: resolveAgentRoleText(parsed.data.role, parsed.data.roleKey, parsed.data.title),
       roleKey: normalizeRoleKey(parsed.data.roleKey),
       title: normalizeTitle(parsed.data.title),
+      capabilities: normalizeCapabilities(parsed.data.capabilities),
       name: parsed.data.name,
       providerType: parsed.data.providerType,
       heartbeatCron: parsed.data.heartbeatCron,
@@ -739,6 +727,11 @@ function normalizeTitle(input: string | null | undefined) {
   return normalized ? normalized : null;
 }
 
+function normalizeCapabilities(input: string | null | undefined) {
+  const normalized = input?.trim();
+  return normalized ? normalized : null;
+}
+
 function resolveAgentRoleText(
   legacyRole: string | undefined,
   roleKeyInput: string | undefined,

package/src/services/heartbeat-service/heartbeat-run.ts

@@ -38,7 +38,7 @@ import {
   projects,
   sql
 } from "bopodev-db";
-import { appendAuditEvent, appendCost } from "bopodev-db";
+import { appendAuditEvent, appendCost, listAgents } from "bopodev-db";
 import { parseRuntimeConfigFromAgentRow } from "../../lib/agent-config";
 import { bootstrapRepositoryWorkspace, ensureIsolatedGitWorktree, GitRuntimeError } from "../../lib/git-runtime";
 import {
@@ -2182,6 +2182,22 @@ async function buildHeartbeatContext(
   const isCommentOrderWake = input.wakeContext?.reason === "issue_comment_recipient";
   const promptMode = resolveHeartbeatPromptMode();
 
+  const companyAgentRows = await listAgents(db, companyId);
+  const teamRoster = companyAgentRows
+    .filter((row) => row.status !== "terminated")
+    .sort((a, b) => {
+      const byName = a.name.localeCompare(b.name);
+      return byName !== 0 ? byName : a.id.localeCompare(b.id);
+    })
+    .map((row) => ({
+      id: row.id,
+      name: row.name,
+      role: row.role,
+      title: row.title ?? null,
+      capabilities: row.capabilities ?? null,
+      status: row.status
+    }));
+
   return {
     companyId,
     agentId: input.agentId,
@@ -2197,6 +2213,7 @@ async function buildHeartbeatContext(
       role: input.agentRole,
       managerAgentId: input.managerAgentId
     },
+    teamRoster,
     state: input.state,
     memoryContext: input.memoryContext,
     runtime: input.runtime,

package/src/services/heartbeat-service/types.ts

@@ -10,6 +10,7 @@ export type HeartbeatProviderType =
   | "gemini_cli"
   | "openai_api"
   | "anthropic_api"
+  | "openclaw_gateway"
   | "http"
   | "shell";
 

package/src/services/template-apply-service.ts

@@ -62,6 +62,7 @@ export async function applyTemplateManifest(
       role: resolveAgentRoleText(agent.role, agent.roleKey, agent.title),
       roleKey: normalizeRoleKey(agent.roleKey),
       title: normalizeTitle(agent.title),
+      capabilities: normalizeCapabilities(agent.capabilities),
       name: agent.name,
       providerType: agent.providerType,
       heartbeatCron: agent.heartbeatCron,
@@ -152,6 +153,11 @@ function normalizeTitle(input: string | null | undefined) {
   return normalized ? normalized : null;
 }
 
+function normalizeCapabilities(input: string | null | undefined) {
+  const normalized = input?.trim();
+  return normalized ? normalized : null;
+}
+
 function resolveAgentRoleText(
   legacyRole: string | undefined,
   roleKeyInput: string | undefined,

package/src/services/template-catalog.ts

@@ -9,7 +9,8 @@ import {
   createTemplate,
   createTemplateVersion,
   getTemplateBySlug,
-  getTemplateVersionByVersion
+  getTemplateVersionByVersion,
+  updateTemplate
 } from "bopodev-db";
 
 type BuiltinTemplateDefinition = {
@@ -28,7 +29,7 @@ const builtinTemplateDefinitions: BuiltinTemplateDefinition[] = [
     slug: "founder-startup-basic",
     name: "Founder Startup Basic",
     description: "Baseline operating company for solo founders launching and shipping with AI agents.",
-    version: "1.0.0",
+    version: "1.0.1",
     status: "published",
     visibility: "company",
     variables: [
@@ -78,6 +79,10 @@ const builtinTemplateDefinitions: BuiltinTemplateDefinition[] = [
         {
           key: "founder-ceo",
           role: "CEO",
+          roleKey: "ceo",
+          title: "Founder CEO",
+          capabilities:
+            "Sets company priorities, runs leadership cadence, hires and coordinates agents toward mission outcomes.",
           name: "Founder CEO",
           providerType: "codex",
           heartbeatCron: "*/15 * * * *",
@@ -119,6 +124,10 @@ const builtinTemplateDefinitions: BuiltinTemplateDefinition[] = [
         {
           key: "founding-engineer",
           role: "Founding Engineer",
+          roleKey: "engineer",
+          title: "Founding Engineer",
+          capabilities:
+            "Ships product improvements with small reviewable changes, tests, and clear handoffs to stakeholders.",
           name: "Founding Engineer",
           managerAgentKey: "founder-ceo",
           providerType: "codex",
@@ -152,6 +161,10 @@ const builtinTemplateDefinitions: BuiltinTemplateDefinition[] = [
         {
           key: "growth-operator",
           role: "Growth Operator",
+          roleKey: "general",
+          title: "Growth Operator",
+          capabilities:
+            "Runs growth experiments, measures funnel impact, and feeds learnings back to leadership with clear next steps.",
           name: "Growth Operator",
           managerAgentKey: "founder-ceo",
           providerType: "codex",
@@ -225,7 +238,7 @@ const builtinTemplateDefinitions: BuiltinTemplateDefinition[] = [
     slug: "marketing-content-engine",
     name: "Marketing Content Engine",
     description: "Content marketing operating template for publishing, distribution, and analytics loops.",
-    version: "1.0.0",
+    version: "1.0.1",
     status: "published",
     visibility: "company",
     variables: [
@@ -276,6 +289,10 @@ const builtinTemplateDefinitions: BuiltinTemplateDefinition[] = [
         {
           key: "head-of-marketing",
           role: "Head of Marketing",
+          roleKey: "cmo",
+          title: "Head of Marketing",
+          capabilities:
+            "Owns marketing narrative, cross-functional alignment, and weekly performance decisions for pipeline growth.",
           name: "Head of Marketing",
           providerType: "codex",
           heartbeatCron: "*/20 * * * *",
@@ -308,6 +325,10 @@ const builtinTemplateDefinitions: BuiltinTemplateDefinition[] = [
         {
           key: "content-strategist",
           role: "Content Strategist",
+          roleKey: "general",
+          title: "Content Strategist",
+          capabilities:
+            "Builds editorial calendars, briefs, and topic architecture tied to audience segments and revenue goals.",
           name: "Content Strategist",
           managerAgentKey: "head-of-marketing",
           providerType: "codex",
@@ -337,6 +358,10 @@ const builtinTemplateDefinitions: BuiltinTemplateDefinition[] = [
         {
           key: "content-writer",
           role: "Content Writer",
+          roleKey: "general",
+          title: "Content Writer",
+          capabilities:
+            "Produces channel-ready drafts, headline and CTA options, and repurposing notes aligned to campaign intent.",
           name: "Content Writer",
           managerAgentKey: "head-of-marketing",
           providerType: "codex",
@@ -367,6 +392,10 @@ const builtinTemplateDefinitions: BuiltinTemplateDefinition[] = [
         {
           key: "distribution-manager",
           role: "Distribution Manager",
+          roleKey: "general",
+          title: "Distribution Manager",
+          capabilities:
+            "Distributes and repurposes assets across channels with tracking discipline and weekly performance reporting.",
           name: "Distribution Manager",
           managerAgentKey: "head-of-marketing",
           providerType: "codex",
@@ -482,6 +511,11 @@ export async function ensureCompanyBuiltinTemplateDefaults(db: BopoDb, companyId
         version: definition.version,
         manifestJson: JSON.stringify(manifest)
       });
+      await updateTemplate(db, {
+        companyId,
+        id: template.id,
+        currentVersion: definition.version
+      });
     }
   }
 }

package/src/validation/issue-routes.ts

@@ -16,7 +16,8 @@ export const createIssueSchema = z.object({
           requestedName: z.string().nullable().optional(),
           requestedManagerAgentId: z.string().nullable().optional(),
           requestedProviderType: z.string().nullable().optional(),
-          requestedRuntimeModel: z.string().nullable().optional()
+          requestedRuntimeModel: z.string().nullable().optional(),
+          requestedCapabilities: z.string().max(4000).nullable().optional()
         })
         .optional()
     })