Soul-driven AI agent with permission-hardened tools, token budgets, and multi-channel access. Runs 24/7 from CLI, Telegram or More.
import { tool, zodSchema } from 'ai';
import { z } from 'zod';
import type { BotManager } from '../bot-manager.js';
export interface BotSpawnTools {
spawn: ReturnType<typeof createSpawnTool>;
retire: ReturnType<typeof createRetireTool>;
}
/**
* bot_spawn / bot_retire — a lead bot's team management: create or retire
* its OWN crew members within the fleet cap. Every action is journaled on
* the lead (removeCrew) and logged. Created crew get standard fail-closed
* defaults (own sandbox + shared folder + comms back to the lead); personas
* run through the persona builder, which cannot invent grants.
*/
export function createBotSpawnTool(manager: BotManager, leadId: string): BotSpawnTools {
const maxCrew = manager.maxCrew();
return {
spawn: createSpawnTool(manager, leadId, maxCrew),
retire: createRetireTool(manager, leadId),
};
}
function createSpawnTool(manager: BotManager, leadId: string, maxCrew: number) {
return tool({
description:
`Create a new specialist crew member for your fleet (cap: ${maxCrew}). Give it a short id, a name, a one-line ` +
`specialty description, and a persona (who it is, how it works). The persona is refined into a structured ` +
`persona file automatically. The new bot starts with safe default permissions (its own sandbox + the fleet ` +
`shared folder) and can message you.`,
inputSchema: zodSchema(z.object({
id: z.string().regex(/^[a-z0-9][a-z0-9-]{0,47}$/).describe('Short lowercase id for the new bot (e.g. "market-research")'),
name: z.string().min(1).max(48).describe('Display name, e.g. "Market Researcher"'),
description: z.string().max(200).describe('One-line specialty description'),
persona: z.string().min(20).max(8000).describe('The bot\'s persona: character, standing instructions, output style'),
})),
execute: async ({ id, name, description, persona }: { id: string; name: string; description: string; persona: string }) => {
// No await on refinePersona: it is 1-2 serial LLM calls and used to
// run INSIDE this tool, stalling the lead's turn once per spawned
// crew member. The member starts on the lead-written persona right
// away; refinement lands in the background and overwrites the file.
const result = manager.addCrew(leadId, { id, name, description, persona });
if (!result.ok) {
return `Error: ${result.error}`;
}
if (result.duplicate) {
return `**${result.manifest.name}** (\`${result.manifest.id}\`) is already on your crew — no new bot created. Check your roster (fleet_status / bot list) before spawning replacements.`;
}
manager.schedulePersonaRefinement(result.manifest.id, name, persona);
return `Crew member created: **${name}** (${result.manifest.id}) — fail-closed defaults, comms linked to you, persona being refined in the background. Dispatch tasks with bot_send (task: true); its results will arrive in your mailbox.`;
},
});
}
function createRetireTool(manager: BotManager, leadId: string) {
return tool({
description:
'Retire one of your OWN crew members (you can only retire bots you lead). Its profile, sandbox, and queue are removed permanently.',
inputSchema: zodSchema(z.object({
id: z.string().describe('The crew bot id to retire'),
})),
execute: async ({ id }: { id: string }) => {
const result = await manager.removeCrew(leadId, id);
if (!result.ok) {
return `Error: ${result.error}`;
}
return `Crew member **${id}** retired. Fleet capacity freed.`;
},
});
}