bopodev-api 0.1.31 → 0.1.33

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

@@ -9,6 +9,7 @@ import {
   ControlPlaneRequestHeadersSchema,
   ControlPlaneRuntimeEnvSchema,
   ExecutionOutcomeSchema,
+  mergeBuiltinSkillIdsForInjection,
   type ExecutionOutcome,
   type RunArtifact,
   type RunCompletionReason,
@@ -59,6 +60,7 @@ import { createHeartbeatRunsRealtimeEvent, loadHeartbeatRunsRealtimeSnapshot } f
 import { publishAttentionSnapshot } from "../../realtime/attention";
 import { publishOfficeOccupantForAgent } from "../../realtime/office-space";
 import { appendProjectBudgetUsage, checkAgentBudget, checkProjectBudget } from "../budget-service";
+import { materializeLinkedSkillsForRuntime } from "../company-skill-file-service";
 import { appendDurableFact, loadAgentMemoryContext, persistHeartbeatMemory } from "../memory-file-service";
 import { calculateModelPricedUsdCost } from "../model-pricing";
 import { runPluginHook } from "../plugin-runtime";
@@ -527,6 +529,7 @@ export async function runHeartbeatForAgent(
   let transcriptLiveHighSignalCount = 0;
   let transcriptPersistFailureReported = false;
   let pluginFailureSummary: string[] = [];
+  let linkedSkillsMaterializationCleanup: (() => Promise<void>) | null = null;
   const seenResultMessages = new Set<string>();
   const runDigestSignals: RunDigestSignal[] = [];
 
@@ -706,13 +709,24 @@ export async function runHeartbeatForAgent(
     if (runMode === "redo") {
       state = clearResumeState(state);
     }
-    const heartbeatRuntimeEnv = buildHeartbeatRuntimeEnv({
-      companyId,
-      agentId: agent.id,
-      heartbeatRunId: runId,
-      canHireAgents: agent.canHireAgents,
-      wakeContext: options?.wakeContext
+    const mergedSkillIds = mergeRuntimeForExecution(
+      { enabledSkillIds: persistedRuntime.enabledSkillIds },
+      state.runtime
+    ).enabledSkillIds;
+    const linkedMaterialized = await materializeLinkedSkillsForRuntime(companyId, {
+      enabledSkillIds: mergedSkillIds
     });
+    linkedSkillsMaterializationCleanup = linkedMaterialized.cleanup;
+    const heartbeatRuntimeEnv: Record<string, string> = {
+      ...buildHeartbeatRuntimeEnv({
+        companyId,
+        agentId: agent.id,
+        heartbeatRunId: runId,
+        canHireAgents: agent.canHireAgents,
+        wakeContext: options?.wakeContext
+      }),
+      ...(linkedMaterialized.root ? { BOPODEV_MATERIALIZED_LINKED_SKILLS_ROOT: linkedMaterialized.root } : {})
+    };
     const runtimeFromConfig = {
       command: persistedRuntime.runtimeCommand,
       args: persistedRuntime.runtimeArgs,
@@ -745,15 +759,27 @@ export async function runHeartbeatForAgent(
       thinkingEffort: persistedRuntime.runtimeThinkingEffort,
       bootstrapPrompt: persistedRuntime.bootstrapPrompt,
       interruptGraceSec: persistedRuntime.interruptGraceSec,
-      runPolicy: persistedRuntime.runPolicy
+      runPolicy: persistedRuntime.runPolicy,
+      enabledSkillIds: persistedRuntime.enabledSkillIds
     };
     const mergedRuntime = mergeRuntimeForExecution(runtimeFromConfig, state.runtime);
+    const runtimeForWorkspace = {
+      ...mergedRuntime,
+      env: {
+        ...(mergedRuntime.env ?? {}),
+        ...(mergedRuntime.enabledSkillIds !== undefined
+          ? {
+              BOPODEV_ENABLED_SKILL_IDS: mergeBuiltinSkillIdsForInjection(mergedRuntime.enabledSkillIds)!.join(",")
+            }
+          : {})
+      }
+    };
     const workspaceResolution = await resolveRuntimeWorkspaceForWorkItems(
       db,
       companyId,
       agent.id,
       contextWorkItems,
-      mergedRuntime
+      runtimeForWorkspace
     );
     await mkdir(join(resolveAgentFallbackWorkspace(companyId, agent.id), "operating"), { recursive: true });
     state = {
@@ -1735,6 +1761,14 @@ export async function runHeartbeatForAgent(
       });
     }
   } finally {
+    if (linkedSkillsMaterializationCleanup) {
+      try {
+        await linkedSkillsMaterializationCleanup();
+      } catch {
+        // Best effort: linked skill temp dir cleanup should not mask heartbeat teardown.
+      }
+      linkedSkillsMaterializationCleanup = null;
+    }
     await transcriptWriteQueue;
     if (discardIdleNoWorkRunAfterFlush) {
       try {
@@ -3380,6 +3414,7 @@ function parseAgentState(stateBlob: string | null) {
           model?: string;
           thinkingEffort?: "auto" | "low" | "medium" | "high";
           bootstrapPrompt?: string;
+          enabledSkillIds?: string[];
           runPolicy?: {
             sandboxMode?: "workspace_write" | "full_access";
             allowWebSearch?: boolean;
@@ -3924,6 +3959,7 @@ function mergeRuntimeForExecution(
         model?: string;
         thinkingEffort?: "auto" | "low" | "medium" | "high";
         bootstrapPrompt?: string;
+        enabledSkillIds?: string[];
         runPolicy?: {
           sandboxMode?: "workspace_write" | "full_access";
           allowWebSearch?: boolean;
@@ -3943,6 +3979,7 @@ function mergeRuntimeForExecution(
         model?: string;
         thinkingEffort?: "auto" | "low" | "medium" | "high";
         bootstrapPrompt?: string;
+        enabledSkillIds?: string[];
         runPolicy?: {
           sandboxMode?: "workspace_write" | "full_access";
           allowWebSearch?: boolean;

package/src/services/memory-file-service.ts

@@ -184,6 +184,76 @@ export async function appendDurableFact(input: {
   return targetFile;
 }
 
+export async function listCompanyMemoryFiles(input: { companyId: string; maxFiles?: number }) {
+  const root = resolveCompanyMemoryRootPath(input.companyId);
+  await mkdir(root, { recursive: true });
+  const maxFiles = Math.max(1, Math.min(MAX_OBSERVABILITY_FILES, input.maxFiles ?? 100));
+  const files = await walkFiles(root, maxFiles);
+  return files.map((filePath) => ({
+    path: filePath,
+    relativePath: relative(root, filePath),
+    memoryRoot: root
+  }));
+}
+
+export async function readCompanyMemoryFile(input: { companyId: string; relativePath: string }) {
+  const root = resolveCompanyMemoryRootPath(input.companyId);
+  await mkdir(root, { recursive: true });
+  const candidate = resolve(root, input.relativePath);
+  if (!isInsidePath(root, candidate)) {
+    throw new Error("Requested memory path is outside of memory root.");
+  }
+  const info = await stat(candidate);
+  if (!info.isFile()) {
+    throw new Error("Requested memory path is not a file.");
+  }
+  if (info.size > MAX_OBSERVABILITY_FILE_BYTES) {
+    throw new Error("Requested memory file exceeds size limit.");
+  }
+  const content = await readFile(candidate, "utf8");
+  return {
+    path: candidate,
+    relativePath: relative(root, candidate),
+    content,
+    sizeBytes: info.size
+  };
+}
+
+export async function listProjectMemoryFiles(input: { companyId: string; projectId: string; maxFiles?: number }) {
+  const root = resolveProjectMemoryRootPath(input.companyId, input.projectId);
+  await mkdir(root, { recursive: true });
+  const maxFiles = Math.max(1, Math.min(MAX_OBSERVABILITY_FILES, input.maxFiles ?? 100));
+  const files = await walkFiles(root, maxFiles);
+  return files.map((filePath) => ({
+    path: filePath,
+    relativePath: relative(root, filePath),
+    memoryRoot: root
+  }));
+}
+
+export async function readProjectMemoryFile(input: { companyId: string; projectId: string; relativePath: string }) {
+  const root = resolveProjectMemoryRootPath(input.companyId, input.projectId);
+  await mkdir(root, { recursive: true });
+  const candidate = resolve(root, input.relativePath);
+  if (!isInsidePath(root, candidate)) {
+    throw new Error("Requested memory path is outside of memory root.");
+  }
+  const info = await stat(candidate);
+  if (!info.isFile()) {
+    throw new Error("Requested memory path is not a file.");
+  }
+  if (info.size > MAX_OBSERVABILITY_FILE_BYTES) {
+    throw new Error("Requested memory file exceeds size limit.");
+  }
+  const content = await readFile(candidate, "utf8");
+  return {
+    path: candidate,
+    relativePath: relative(root, candidate),
+    content,
+    sizeBytes: info.size
+  };
+}
+
 export async function listAgentMemoryFiles(input: {
   companyId: string;
   agentId: string;

package/src/services/template-catalog.ts

@@ -28,8 +28,9 @@ 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.1",
+    description:
+      "Baseline operating company for solo founders launching and shipping with AI agents. Aligns with Bopo company file export (.bopo.yaml, projects/, agents/, tasks/) so operators can download a zip, edit markdown in git, and import a new company from the archive.",
+    version: "1.0.2",
     status: "published",
     visibility: "company",
     variables: [
@@ -117,7 +118,11 @@ const builtinTemplateDefinitions: BuiltinTemplateDefinition[] = [
               "",
               "Quality bar:",
               "- Be concise, specific, and execution-ready.",
-              "- Do not produce generic plans without owners, dates, and measurable outcomes."
+              "- Do not produce generic plans without owners, dates, and measurable outcomes.",
+              "",
+              "Portable company files:",
+              "- Under workspace Templates → Export, the app can produce a zip with .bopo.yaml and per-agent markdown under agents/<slug>/.",
+              "- That tree can be edited in git and re-imported to create another company; keep those files consistent with how you actually run."
             ].join("\n")
           }
         },
@@ -237,8 +242,9 @@ 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.1",
+    description:
+      "Content marketing operating template for publishing, distribution, and analytics loops. Uses the same Bopo company zip layout as file export/import so marketing orgs can be versioned in git and cloned via archive import.",
+    version: "1.0.2",
     status: "published",
     visibility: "company",
     variables: [
@@ -318,7 +324,11 @@ const builtinTemplateDefinitions: BuiltinTemplateDefinition[] = [
               "",
               "Escalation:",
               "- Escalate major brand/positioning shifts, compliance-sensitive claims, or budget overrun risks.",
-              "- If dependencies block publication, create unblock issues within 24h."
+              "- If dependencies block publication, create unblock issues within 24h.",
+              "",
+              "Portable company files:",
+              "- Under workspace Templates → Export, leaders can download a zip with .bopo.yaml and agent markdown under agents/<slug>/.",
+              "- That folder tree can be edited in git and re-imported to stand up a new company; keep exported docs aligned with campaigns you actually ship."
             ].join("\n")
           }
         },
@@ -514,6 +524,9 @@ export async function ensureCompanyBuiltinTemplateDefaults(db: BopoDb, companyId
       await updateTemplate(db, {
         companyId,
         id: template.id,
+        name: definition.name,
+        description: definition.description,
+        variablesJson: JSON.stringify(variables),
         currentVersion: definition.version
       });
     }