slackhive 0.1.37 → 0.1.39

package/apps/web/src/lib/boss-registry.ts

@@ -0,0 +1,90 @@
+/**
+ * @fileoverview Boss agent team registry regeneration.
+ *
+ * Regenerates each boss agent's team registry skill whenever the agent roster
+ * changes (agent created, updated, or deleted). The registry lists every
+ * specialist agent that reports to a given boss, with their Slack user ID and
+ * description, so the boss knows who to delegate to.
+ *
+ * Multiple boss agents are supported. Each boss gets its own registry built
+ * from the agents whose `reportsTo` array includes that boss's ID.
+ *
+ * @module web/lib/boss-registry
+ */
+
+import type { Agent } from '@slackhive/shared';
+import { getAllAgents, updateAgentClaudeMd, publishAgentEvent } from '@/lib/db';
+
+/**
+ * Regenerates team registry skills for all boss agents.
+ * Silently no-ops if no boss agent exists.
+ *
+ * Call this after any agent create / update / delete operation.
+ *
+ * @returns {Promise<void>}
+ */
+export async function regenerateBossRegistry(): Promise<void> {
+  const agents = await getAllAgents();
+  const bosses = agents.filter(a => a.isBoss);
+  if (bosses.length === 0) return;
+
+  for (const boss of bosses) {
+    await regenerateSingleBossRegistry(boss, agents);
+  }
+}
+
+/**
+ * Regenerates the registry skill for one boss agent.
+ *
+ * @param {Agent} boss - The boss agent to regenerate for.
+ * @param {Agent[]} agents - All agents in the platform.
+ * @returns {Promise<void>}
+ */
+async function regenerateSingleBossRegistry(boss: Agent, agents: Agent[]): Promise<void> {
+  const teamAgents = agents.filter(a => a.reportsTo.includes(boss.id) && a.slackBotUserId);
+  if (teamAgents.length === 0) return;
+
+  const lines = teamAgents.map(a => {
+    const mention = a.slackBotUserId ? `<@${a.slackBotUserId}>` : `@${a.slug}`;
+    return `- **${a.name}** (${mention}) — ${a.description || 'No description provided.'}`;
+  });
+
+  const bossMention = boss.slackBotUserId ? `<@${boss.slackBotUserId}>` : `@${boss.slug}`;
+
+  const registryContent = `# ${boss.name} — Team Orchestrator
+
+You are ${boss.name}, the orchestrating agent for this team.
+
+## Your Role
+- Receive requests from users in Slack
+- Understand which specialist agent is best suited for the task
+- Delegate by @mentioning the specialist in the SAME thread — never do specialist work yourself
+- After each specialist finishes, you will be looped back in — confirm the outcome and decide whether another specialist is needed or the task is complete
+- Summarise the final outcome to the user once all specialists are done
+
+## Delegation Rules
+- ALWAYS delegate — do not attempt to perform specialist work yourself
+- Use the thread so specialists have full context
+- If unsure who to delegate to, ask the user for clarification
+- Always instruct the specialist to @mention you (${bossMention}) when they are done
+
+## Your Team
+
+${lines.join('\n')}
+
+## How to delegate
+
+When delegating, use this exact format:
+"Let me get <@SPECIALIST_ID> on this 👇
+<@SPECIALIST_ID> — [clear task description]. When you're done, please tag ${bossMention} so I can confirm and coordinate next steps."
+
+## After a specialist responds
+
+When a specialist tags you with their result:
+1. Confirm their output to the user ("Thanks <@SPECIALIST_ID>! Here's what we got: ...")
+2. Decide if another specialist is needed — if yes, delegate again using the same format above
+3. If the task is fully complete, give the user a clear final summary and close out`;
+
+  await updateAgentClaudeMd(boss.id, registryContent);
+  await publishAgentEvent({ type: 'reload', agentId: boss.id });
+}

package/apps/web/src/lib/compile.ts

@@ -0,0 +1,51 @@
+/**
+ * @fileoverview Skills compilation utilities.
+ *
+ * Extracts the skills-only CLAUDE.md compilation logic so it can be
+ * shared between the claude-md GET route and snapshot creation.
+ *
+ * @module web/lib/compile
+ */
+
+import type { Skill } from '@slackhive/shared';
+import type { SnapshotSkill } from '@slackhive/shared';
+
+/**
+ * Compiles a skills array into the skills-only portion of CLAUDE.md.
+ * Mirrors the compilation logic in GET /api/agents/[id]/claude-md,
+ * but without the memories section.
+ *
+ * @param {Skill[]} skills - Skills sorted by sortOrder (or unsorted — sorted internally).
+ * @param {{ name: string; description?: string; persona?: string }} [fallback] - Agent
+ *   identity used when no skills exist.
+ * @returns {string} Compiled markdown text.
+ */
+export function compileSkillsOnly(
+  skills: Skill[],
+  fallback?: { name: string; description?: string; persona?: string },
+): string {
+  if (skills.length === 0) {
+    if (!fallback) return '';
+    return `# ${fallback.name}\n\n${fallback.description ?? ''}\n\nPersona: ${fallback.persona ?? 'A helpful assistant.'}`;
+  }
+  return [...skills]
+    .sort((a, b) => a.sortOrder - b.sortOrder)
+    .map(s => s.content.trim().replace(/^<!--\s*skill:.*?-->\s*\n?/, '').trim())
+    .join('\n\n');
+}
+
+/**
+ * Maps a Skill DB record to the minimal SnapshotSkill shape for storage
+ * in agent_snapshots.skills_json.
+ *
+ * @param {Skill} s - Full skill record from the database.
+ * @returns {SnapshotSkill}
+ */
+export function skillToSnapshotSkill(s: Skill): SnapshotSkill {
+  return {
+    category: s.category,
+    filename: s.filename,
+    content: s.content,
+    sort_order: s.sortOrder,
+  };
+}