@jcheesepkg/nanobot 0.1.0

package/dist/agent/loop.mjs

@@ -0,0 +1,232 @@
+import { createInboundMessage, createOutboundMessage, init_events } from "../bus/events.mjs";
+import { ContextBuilder } from "./context.mjs";
+import { ToolRegistry } from "./tools/registry.mjs";
+import { EditFileTool, ListDirTool, ReadFileTool, WriteFileTool } from "./tools/filesystem.mjs";
+import { ExecTool } from "./tools/shell.mjs";
+import { WebFetchTool, WebSearchTool } from "./tools/web.mjs";
+import { MessageTool } from "./tools/message.mjs";
+import { SpawnTool } from "./tools/spawn.mjs";
+import { CronTool } from "./tools/cron.mjs";
+import { SubagentManager } from "./subagent.mjs";
+import { SessionManager } from "../session/manager.mjs";
+
+//#region src/agent/loop.ts
+init_events();
+/**
+* The agent loop: core processing engine.
+*
+* 1. Receives messages from the bus
+* 2. Builds context with history, memory, skills
+* 3. Calls the LLM
+* 4. Executes tool calls
+* 5. Sends responses back
+*/
+var AgentLoop = class {
+	bus;
+	provider;
+	workspace;
+	model;
+	maxIterations;
+	context;
+	sessions;
+	tools;
+	subagents;
+	_running = false;
+	constructor(params) {
+		this.bus = params.bus;
+		this.provider = params.provider;
+		this.workspace = params.workspace;
+		this.model = params.model ?? params.provider.getDefaultModel();
+		this.maxIterations = params.maxIterations ?? 20;
+		const execConfig = params.execConfig ?? {
+			timeout: 60,
+			restrictToWorkspace: false
+		};
+		this.context = new ContextBuilder(params.workspace);
+		this.sessions = new SessionManager(params.workspace);
+		this.tools = new ToolRegistry();
+		this.subagents = new SubagentManager({
+			provider: params.provider,
+			workspace: params.workspace,
+			bus: params.bus,
+			model: this.model,
+			braveApiKey: params.braveApiKey,
+			execConfig
+		});
+		this.registerDefaultTools(execConfig, params.braveApiKey, params.cronService);
+	}
+	registerDefaultTools(execConfig, braveApiKey, cronService) {
+		this.tools.register(new ReadFileTool());
+		this.tools.register(new WriteFileTool());
+		this.tools.register(new EditFileTool());
+		this.tools.register(new ListDirTool());
+		this.tools.register(new ExecTool({
+			workingDir: this.workspace,
+			timeout: execConfig.timeout,
+			restrictToWorkspace: execConfig.restrictToWorkspace
+		}));
+		this.tools.register(new WebSearchTool({ apiKey: braveApiKey }));
+		this.tools.register(new WebFetchTool());
+		const messageTool = new MessageTool({ sendCallback: (msg) => this.bus.publishOutbound(msg) });
+		this.tools.register(messageTool);
+		const spawnTool = new SpawnTool(this.subagents);
+		this.tools.register(spawnTool);
+		if (cronService) this.tools.register(new CronTool(cronService));
+	}
+	/** Run the agent loop, processing messages from the bus. */
+	async run() {
+		this._running = true;
+		console.log("Agent loop started");
+		while (this._running) try {
+			const msg = await withTimeout(this.bus.consumeInbound(), 1e3);
+			try {
+				const response = await this.processMessage(msg);
+				if (response) await this.bus.publishOutbound(response);
+			} catch (err) {
+				console.error("Error processing message:", err);
+				await this.bus.publishOutbound(createOutboundMessage({
+					channel: msg.channel,
+					chatId: msg.chatId,
+					content: `Sorry, I encountered an error: ${err instanceof Error ? err.message : err}`
+				}));
+			}
+		} catch {}
+	}
+	/** Stop the agent loop. */
+	stop() {
+		this._running = false;
+		console.log("Agent loop stopping");
+	}
+	/** Process a single inbound message. */
+	async processMessage(msg) {
+		if (msg.channel === "system") return this.processSystemMessage(msg);
+		console.log(`Processing message from ${msg.channel}:${msg.senderId}`);
+		const sessionKey = `${msg.channel}:${msg.chatId}`;
+		const session = this.sessions.getOrCreate(sessionKey);
+		this.updateToolContexts(msg.channel, msg.chatId);
+		const messages = this.context.buildMessages({
+			history: session.getHistory(),
+			currentMessage: msg.content,
+			media: msg.media.length > 0 ? msg.media : void 0,
+			channel: msg.channel,
+			chatId: msg.chatId
+		});
+		const finalContent = await this.runAgentLoop(messages);
+		session.addMessage("user", msg.content);
+		session.addMessage("assistant", finalContent);
+		this.sessions.save(session);
+		return createOutboundMessage({
+			channel: msg.channel,
+			chatId: msg.chatId,
+			content: finalContent
+		});
+	}
+	async processSystemMessage(msg) {
+		console.log(`Processing system message from ${msg.senderId}`);
+		let originChannel;
+		let originChatId;
+		if (msg.chatId.includes(":")) {
+			const [ch, id] = msg.chatId.split(":", 2);
+			originChannel = ch;
+			originChatId = id;
+		} else {
+			originChannel = "cli";
+			originChatId = msg.chatId;
+		}
+		const sessionKey = `${originChannel}:${originChatId}`;
+		const session = this.sessions.getOrCreate(sessionKey);
+		this.updateToolContexts(originChannel, originChatId);
+		const messages = this.context.buildMessages({
+			history: session.getHistory(),
+			currentMessage: msg.content,
+			channel: originChannel,
+			chatId: originChatId
+		});
+		const finalContent = await this.runAgentLoop(messages);
+		session.addMessage("user", `[System: ${msg.senderId}] ${msg.content}`);
+		session.addMessage("assistant", finalContent);
+		this.sessions.save(session);
+		return createOutboundMessage({
+			channel: originChannel,
+			chatId: originChatId,
+			content: finalContent
+		});
+	}
+	async runAgentLoop(messages) {
+		let finalContent = null;
+		for (let i = 0; i < this.maxIterations; i++) {
+			const response = await this.provider.chat({
+				messages,
+				tools: this.tools.getDefinitions(),
+				model: this.model
+			});
+			if (response.hasToolCalls) {
+				const toolCallDicts = response.toolCalls.map((tc) => ({
+					id: tc.id,
+					type: "function",
+					function: {
+						name: tc.name,
+						arguments: JSON.stringify(tc.arguments)
+					}
+				}));
+				this.context.addAssistantMessage(messages, response.content, toolCallDicts);
+				for (const tc of response.toolCalls) {
+					console.log(`Executing tool: ${tc.name} with arguments: ${JSON.stringify(tc.arguments)}`);
+					const result = await this.tools.execute(tc.name, tc.arguments);
+					this.context.addToolResult(messages, tc.id, tc.name, result);
+				}
+			} else {
+				finalContent = response.content;
+				break;
+			}
+		}
+		return finalContent ?? "I've completed processing but have no response to give.";
+	}
+	updateToolContexts(channel, chatId) {
+		const messageTool = this.tools.get("message");
+		if (messageTool instanceof MessageTool) messageTool.setContext(channel, chatId);
+		const spawnTool = this.tools.get("spawn");
+		if (spawnTool instanceof SpawnTool) spawnTool.setContext(channel, chatId);
+		const cronTool = this.tools.get("cron");
+		if (cronTool instanceof CronTool) cronTool.setContext(channel, chatId);
+	}
+	/** Process a message directly (for CLI or cron usage). */
+	async processDirect(content, sessionKey = "cli:direct", channel = "cli", chatId = "direct") {
+		createInboundMessage({
+			channel,
+			senderId: "user",
+			chatId,
+			content
+		});
+		const session = this.sessions.getOrCreate(sessionKey);
+		this.updateToolContexts(channel, chatId);
+		const messages = this.context.buildMessages({
+			history: session.getHistory(),
+			currentMessage: content,
+			channel,
+			chatId
+		});
+		const finalContent = await this.runAgentLoop(messages);
+		session.addMessage("user", content);
+		session.addMessage("assistant", finalContent);
+		this.sessions.save(session);
+		return finalContent;
+	}
+};
+/** Promise.race with a timeout. */
+function withTimeout(promise, ms) {
+	return new Promise((resolve, reject) => {
+		const timer = setTimeout(() => reject(/* @__PURE__ */ new Error("timeout")), ms);
+		promise.then((val) => {
+			clearTimeout(timer);
+			resolve(val);
+		}, (err) => {
+			clearTimeout(timer);
+			reject(err);
+		});
+	});
+}
+
+//#endregion
+export { AgentLoop };
+//# sourceMappingURL=loop.mjs.map

package/dist/agent/loop.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.mjs","names":[],"sources":["../../src/agent/loop.ts"],"sourcesContent":["import type { LLMProvider, ChatMessage } from \"../providers/base.js\";\nimport type { MessageBus } from \"../bus/queue.js\";\nimport type {\n  InboundMessage,\n  OutboundMessage,\n} from \"../bus/events.js\";\nimport { createInboundMessage, createOutboundMessage } from \"../bus/events.js\";\nimport { ContextBuilder } from \"./context.js\";\nimport { ToolRegistry } from \"./tools/registry.js\";\nimport {\n  ReadFileTool,\n  WriteFileTool,\n  EditFileTool,\n  ListDirTool,\n} from \"./tools/filesystem.js\";\nimport { ExecTool } from \"./tools/shell.js\";\nimport { WebSearchTool, WebFetchTool } from \"./tools/web.js\";\nimport { MessageTool } from \"./tools/message.js\";\nimport { SpawnTool } from \"./tools/spawn.js\";\nimport { CronTool } from \"./tools/cron.js\";\nimport { SubagentManager } from \"./subagent.js\";\nimport { SessionManager } from \"../session/manager.js\";\nimport type { ExecToolConfig } from \"../config/schema.js\";\nimport type { CronService } from \"../cron/service.js\";\n\n/**\n * The agent loop: core processing engine.\n *\n * 1. Receives messages from the bus\n * 2. Builds context with history, memory, skills\n * 3. Calls the LLM\n * 4. Executes tool calls\n * 5. Sends responses back\n */\nexport class AgentLoop {\n  private bus: MessageBus;\n  private provider: LLMProvider;\n  private workspace: string;\n  private model: string;\n  private maxIterations: number;\n\n  readonly context: ContextBuilder;\n  readonly sessions: SessionManager;\n  readonly tools: ToolRegistry;\n  readonly subagents: SubagentManager;\n\n  private _running = false;\n\n  constructor(params: {\n    bus: MessageBus;\n    provider: LLMProvider;\n    workspace: string;\n    model?: string;\n    maxIterations?: number;\n    braveApiKey?: string;\n    execConfig?: ExecToolConfig;\n    cronService?: CronService;\n  }) {\n    this.bus = params.bus;\n    this.provider = params.provider;\n    this.workspace = params.workspace;\n    this.model = params.model ?? params.provider.getDefaultModel();\n    this.maxIterations = params.maxIterations ?? 20;\n\n    const execConfig = params.execConfig ?? {\n      timeout: 60,\n      restrictToWorkspace: false,\n    };\n\n    this.context = new ContextBuilder(params.workspace);\n    this.sessions = new SessionManager(params.workspace);\n    this.tools = new ToolRegistry();\n    this.subagents = new SubagentManager({\n      provider: params.provider,\n      workspace: params.workspace,\n      bus: params.bus,\n      model: this.model,\n      braveApiKey: params.braveApiKey,\n      execConfig,\n    });\n\n    this.registerDefaultTools(execConfig, params.braveApiKey, params.cronService);\n  }\n\n  private registerDefaultTools(\n    execConfig: ExecToolConfig,\n    braveApiKey?: string,\n    cronService?: CronService,\n  ): void {\n    // File tools\n    this.tools.register(new ReadFileTool());\n    this.tools.register(new WriteFileTool());\n    this.tools.register(new EditFileTool());\n    this.tools.register(new ListDirTool());\n\n    // Shell tool\n    this.tools.register(\n      new ExecTool({\n        workingDir: this.workspace,\n        timeout: execConfig.timeout,\n        restrictToWorkspace: execConfig.restrictToWorkspace,\n      }),\n    );\n\n    // Web tools\n    this.tools.register(new WebSearchTool({ apiKey: braveApiKey }));\n    this.tools.register(new WebFetchTool());\n\n    // Message tool\n    const messageTool = new MessageTool({\n      sendCallback: (msg) => this.bus.publishOutbound(msg),\n    });\n    this.tools.register(messageTool);\n\n    // Spawn tool\n    const spawnTool = new SpawnTool(this.subagents);\n    this.tools.register(spawnTool);\n\n    // Cron tool\n    if (cronService) {\n      this.tools.register(new CronTool(cronService));\n    }\n  }\n\n  /** Run the agent loop, processing messages from the bus. */\n  async run(): Promise<void> {\n    this._running = true;\n    console.log(\"Agent loop started\");\n\n    while (this._running) {\n      try {\n        const msg = await withTimeout(this.bus.consumeInbound(), 1000);\n\n        try {\n          const response = await this.processMessage(msg);\n          if (response) {\n            await this.bus.publishOutbound(response);\n          }\n        } catch (err) {\n          console.error(\"Error processing message:\", err);\n          await this.bus.publishOutbound(\n            createOutboundMessage({\n              channel: msg.channel,\n              chatId: msg.chatId,\n              content: `Sorry, I encountered an error: ${err instanceof Error ? err.message : err}`,\n            }),\n          );\n        }\n      } catch {\n        // timeout, continue\n      }\n    }\n  }\n\n  /** Stop the agent loop. */\n  stop(): void {\n    this._running = false;\n    console.log(\"Agent loop stopping\");\n  }\n\n  /** Process a single inbound message. */\n  private async processMessage(\n    msg: InboundMessage,\n  ): Promise<OutboundMessage | null> {\n    // Handle system messages (subagent announces)\n    if (msg.channel === \"system\") {\n      return this.processSystemMessage(msg);\n    }\n\n    console.log(`Processing message from ${msg.channel}:${msg.senderId}`);\n\n    const sessionKey = `${msg.channel}:${msg.chatId}`;\n    const session = this.sessions.getOrCreate(sessionKey);\n\n    // Update tool contexts\n    this.updateToolContexts(msg.channel, msg.chatId);\n\n    // Build initial messages\n    const messages = this.context.buildMessages({\n      history: session.getHistory(),\n      currentMessage: msg.content,\n      media: msg.media.length > 0 ? msg.media : undefined,\n      channel: msg.channel,\n      chatId: msg.chatId,\n    });\n\n    // Agent loop\n    const finalContent = await this.runAgentLoop(messages);\n\n    // Save to session\n    session.addMessage(\"user\", msg.content);\n    session.addMessage(\"assistant\", finalContent);\n    this.sessions.save(session);\n\n    return createOutboundMessage({\n      channel: msg.channel,\n      chatId: msg.chatId,\n      content: finalContent,\n    });\n  }\n\n  private async processSystemMessage(\n    msg: InboundMessage,\n  ): Promise<OutboundMessage | null> {\n    console.log(`Processing system message from ${msg.senderId}`);\n\n    let originChannel: string;\n    let originChatId: string;\n\n    if (msg.chatId.includes(\":\")) {\n      const [ch, id] = msg.chatId.split(\":\", 2);\n      originChannel = ch;\n      originChatId = id;\n    } else {\n      originChannel = \"cli\";\n      originChatId = msg.chatId;\n    }\n\n    const sessionKey = `${originChannel}:${originChatId}`;\n    const session = this.sessions.getOrCreate(sessionKey);\n\n    this.updateToolContexts(originChannel, originChatId);\n\n    const messages = this.context.buildMessages({\n      history: session.getHistory(),\n      currentMessage: msg.content,\n      channel: originChannel,\n      chatId: originChatId,\n    });\n\n    const finalContent = await this.runAgentLoop(messages);\n\n    session.addMessage(\"user\", `[System: ${msg.senderId}] ${msg.content}`);\n    session.addMessage(\"assistant\", finalContent);\n    this.sessions.save(session);\n\n    return createOutboundMessage({\n      channel: originChannel,\n      chatId: originChatId,\n      content: finalContent,\n    });\n  }\n\n  private async runAgentLoop(messages: ChatMessage[]): Promise<string> {\n    let finalContent: string | null = null;\n\n    for (let i = 0; i < this.maxIterations; i++) {\n      const response = await this.provider.chat({\n        messages,\n        tools: this.tools.getDefinitions(),\n        model: this.model,\n      });\n\n      if (response.hasToolCalls) {\n        const toolCallDicts = response.toolCalls.map((tc) => ({\n          id: tc.id,\n          type: \"function\" as const,\n          function: {\n            name: tc.name,\n            arguments: JSON.stringify(tc.arguments),\n          },\n        }));\n\n        this.context.addAssistantMessage(\n          messages,\n          response.content,\n          toolCallDicts,\n        );\n\n        for (const tc of response.toolCalls) {\n          console.log(\n            `Executing tool: ${tc.name} with arguments: ${JSON.stringify(tc.arguments)}`,\n          );\n          const result = await this.tools.execute(tc.name, tc.arguments);\n          this.context.addToolResult(messages, tc.id, tc.name, result);\n        }\n      } else {\n        finalContent = response.content;\n        break;\n      }\n    }\n\n    return finalContent ?? \"I've completed processing but have no response to give.\";\n  }\n\n  private updateToolContexts(channel: string, chatId: string): void {\n    const messageTool = this.tools.get(\"message\");\n    if (messageTool instanceof MessageTool) {\n      messageTool.setContext(channel, chatId);\n    }\n\n    const spawnTool = this.tools.get(\"spawn\");\n    if (spawnTool instanceof SpawnTool) {\n      spawnTool.setContext(channel, chatId);\n    }\n\n    const cronTool = this.tools.get(\"cron\");\n    if (cronTool instanceof CronTool) {\n      cronTool.setContext(channel, chatId);\n    }\n  }\n\n  /** Process a message directly (for CLI or cron usage). */\n  async processDirect(\n    content: string,\n    sessionKey = \"cli:direct\",\n    channel = \"cli\",\n    chatId = \"direct\",\n  ): Promise<string> {\n    const msg = createInboundMessage({\n      channel,\n      senderId: \"user\",\n      chatId,\n      content,\n    });\n\n    // Use inline version of processMessage for direct calls\n    const session = this.sessions.getOrCreate(sessionKey);\n    this.updateToolContexts(channel, chatId);\n\n    const messages = this.context.buildMessages({\n      history: session.getHistory(),\n      currentMessage: content,\n      channel,\n      chatId,\n    });\n\n    const finalContent = await this.runAgentLoop(messages);\n\n    session.addMessage(\"user\", content);\n    session.addMessage(\"assistant\", finalContent);\n    this.sessions.save(session);\n\n    return finalContent;\n  }\n}\n\n/** Promise.race with a timeout. */\nfunction withTimeout<T>(promise: Promise<T>, ms: number): Promise<T> {\n  return new Promise<T>((resolve, reject) => {\n    const timer = setTimeout(() => reject(new Error(\"timeout\")), ms);\n    promise.then(\n      (val) => {\n        clearTimeout(timer);\n        resolve(val);\n      },\n      (err) => {\n        clearTimeout(timer);\n        reject(err);\n      },\n    );\n  });\n}\n"],"mappings":"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"}

package/dist/agent/memory.d.mts

@@ -0,0 +1,30 @@
+//#region src/agent/memory.d.ts
+/**
+ * Memory system for the agent.
+ * Supports daily notes (memory/YYYY-MM-DD.md) and long-term memory (MEMORY.md).
+ */
+declare class MemoryStore {
+  private workspace;
+  private memoryDir;
+  private memoryFile;
+  constructor(workspace: string);
+  /** Get path to today's memory file. */
+  getTodayFile(): string;
+  /** Read today's memory notes. */
+  readToday(): string;
+  /** Append content to today's memory notes. */
+  appendToday(content: string): void;
+  /** Read long-term memory (MEMORY.md). */
+  readLongTerm(): string;
+  /** Write to long-term memory (MEMORY.md). */
+  writeLongTerm(content: string): void;
+  /** Get memories from the last N days. */
+  getRecentMemories(days?: number): string;
+  /** List all memory files sorted by date (newest first). */
+  listMemoryFiles(): string[];
+  /** Get memory context for the agent prompt. */
+  getMemoryContext(): string;
+}
+//#endregion
+export { MemoryStore };
+//# sourceMappingURL=memory.d.mts.map

package/dist/agent/memory.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.mts","names":[],"sources":["../../src/agent/memory.ts"],"mappings":";;AAQA;;;cAAa,WAAA;EAAA,QACH,SAAA;EAAA,QACA,SAAA;EAAA,QACA,UAAA;cAEI,SAAA;EAAA;EAOZ,YAAA,CAAA;EAKA;EAAA,SAAA,CAAA;EASY;EAAZ,WAAA,CAAY,OAAA;EAuBZ;EARA,YAAA,CAAA;EAaA;EALA,aAAA,CAAc,OAAA;EAwBd;EAnBA,iBAAA,CAAkB,IAAA;EA8BF;EAXhB,eAAA,CAAA;;EAWA,gBAAA,CAAA;AAAA"}

package/dist/agent/memory.mjs

@@ -0,0 +1,77 @@
+import { ensureDir, todayDate } from "../utils/helpers.mjs";
+import { existsSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+
+//#region src/agent/memory.ts
+/**
+* Memory system for the agent.
+* Supports daily notes (memory/YYYY-MM-DD.md) and long-term memory (MEMORY.md).
+*/
+var MemoryStore = class {
+	workspace;
+	memoryDir;
+	memoryFile;
+	constructor(workspace) {
+		this.workspace = workspace;
+		this.memoryDir = ensureDir(join(workspace, "memory"));
+		this.memoryFile = join(this.memoryDir, "MEMORY.md");
+	}
+	/** Get path to today's memory file. */
+	getTodayFile() {
+		return join(this.memoryDir, `${todayDate()}.md`);
+	}
+	/** Read today's memory notes. */
+	readToday() {
+		const todayFile = this.getTodayFile();
+		if (existsSync(todayFile)) return readFileSync(todayFile, "utf-8");
+		return "";
+	}
+	/** Append content to today's memory notes. */
+	appendToday(content) {
+		const todayFile = this.getTodayFile();
+		let finalContent;
+		if (existsSync(todayFile)) finalContent = readFileSync(todayFile, "utf-8") + "\n" + content;
+		else finalContent = `# ${todayDate()}\n\n${content}`;
+		writeFileSync(todayFile, finalContent, "utf-8");
+	}
+	/** Read long-term memory (MEMORY.md). */
+	readLongTerm() {
+		if (existsSync(this.memoryFile)) return readFileSync(this.memoryFile, "utf-8");
+		return "";
+	}
+	/** Write to long-term memory (MEMORY.md). */
+	writeLongTerm(content) {
+		writeFileSync(this.memoryFile, content, "utf-8");
+	}
+	/** Get memories from the last N days. */
+	getRecentMemories(days = 7) {
+		const memories = [];
+		const today = /* @__PURE__ */ new Date();
+		for (let i = 0; i < days; i++) {
+			const date = new Date(today);
+			date.setDate(date.getDate() - i);
+			const dateStr = date.toISOString().slice(0, 10);
+			const filePath = join(this.memoryDir, `${dateStr}.md`);
+			if (existsSync(filePath)) memories.push(readFileSync(filePath, "utf-8"));
+		}
+		return memories.join("\n\n---\n\n");
+	}
+	/** List all memory files sorted by date (newest first). */
+	listMemoryFiles() {
+		if (!existsSync(this.memoryDir)) return [];
+		return readdirSync(this.memoryDir).filter((f) => /^\d{4}-\d{2}-\d{2}\.md$/.test(f)).sort().reverse().map((f) => join(this.memoryDir, f));
+	}
+	/** Get memory context for the agent prompt. */
+	getMemoryContext() {
+		const parts = [];
+		const longTerm = this.readLongTerm();
+		if (longTerm) parts.push("## Long-term Memory\n" + longTerm);
+		const today = this.readToday();
+		if (today) parts.push("## Today's Notes\n" + today);
+		return parts.join("\n\n");
+	}
+};
+
+//#endregion
+export { MemoryStore };
+//# sourceMappingURL=memory.mjs.map

package/dist/agent/memory.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.mjs","names":[],"sources":["../../src/agent/memory.ts"],"sourcesContent":["import { readFileSync, writeFileSync, existsSync, readdirSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { ensureDir, todayDate } from \"../utils/helpers.js\";\n\n/**\n * Memory system for the agent.\n * Supports daily notes (memory/YYYY-MM-DD.md) and long-term memory (MEMORY.md).\n */\nexport class MemoryStore {\n  private workspace: string;\n  private memoryDir: string;\n  private memoryFile: string;\n\n  constructor(workspace: string) {\n    this.workspace = workspace;\n    this.memoryDir = ensureDir(join(workspace, \"memory\"));\n    this.memoryFile = join(this.memoryDir, \"MEMORY.md\");\n  }\n\n  /** Get path to today's memory file. */\n  getTodayFile(): string {\n    return join(this.memoryDir, `${todayDate()}.md`);\n  }\n\n  /** Read today's memory notes. */\n  readToday(): string {\n    const todayFile = this.getTodayFile();\n    if (existsSync(todayFile)) {\n      return readFileSync(todayFile, \"utf-8\");\n    }\n    return \"\";\n  }\n\n  /** Append content to today's memory notes. */\n  appendToday(content: string): void {\n    const todayFile = this.getTodayFile();\n    let finalContent: string;\n\n    if (existsSync(todayFile)) {\n      const existing = readFileSync(todayFile, \"utf-8\");\n      finalContent = existing + \"\\n\" + content;\n    } else {\n      finalContent = `# ${todayDate()}\\n\\n${content}`;\n    }\n\n    writeFileSync(todayFile, finalContent, \"utf-8\");\n  }\n\n  /** Read long-term memory (MEMORY.md). */\n  readLongTerm(): string {\n    if (existsSync(this.memoryFile)) {\n      return readFileSync(this.memoryFile, \"utf-8\");\n    }\n    return \"\";\n  }\n\n  /** Write to long-term memory (MEMORY.md). */\n  writeLongTerm(content: string): void {\n    writeFileSync(this.memoryFile, content, \"utf-8\");\n  }\n\n  /** Get memories from the last N days. */\n  getRecentMemories(days = 7): string {\n    const memories: string[] = [];\n    const today = new Date();\n\n    for (let i = 0; i < days; i++) {\n      const date = new Date(today);\n      date.setDate(date.getDate() - i);\n      const dateStr = date.toISOString().slice(0, 10);\n      const filePath = join(this.memoryDir, `${dateStr}.md`);\n\n      if (existsSync(filePath)) {\n        memories.push(readFileSync(filePath, \"utf-8\"));\n      }\n    }\n\n    return memories.join(\"\\n\\n---\\n\\n\");\n  }\n\n  /** List all memory files sorted by date (newest first). */\n  listMemoryFiles(): string[] {\n    if (!existsSync(this.memoryDir)) return [];\n\n    return readdirSync(this.memoryDir)\n      .filter((f) => /^\\d{4}-\\d{2}-\\d{2}\\.md$/.test(f))\n      .sort()\n      .reverse()\n      .map((f) => join(this.memoryDir, f));\n  }\n\n  /** Get memory context for the agent prompt. */\n  getMemoryContext(): string {\n    const parts: string[] = [];\n\n    const longTerm = this.readLongTerm();\n    if (longTerm) {\n      parts.push(\"## Long-term Memory\\n\" + longTerm);\n    }\n\n    const today = this.readToday();\n    if (today) {\n      parts.push(\"## Today's Notes\\n\" + today);\n    }\n\n    return parts.join(\"\\n\\n\");\n  }\n}\n"],"mappings":";;;;;;;;;AAQA,IAAa,cAAb,MAAyB;CACvB,AAAQ;CACR,AAAQ;CACR,AAAQ;CAER,YAAY,WAAmB;AAC7B,OAAK,YAAY;AACjB,OAAK,YAAY,UAAU,KAAK,WAAW,SAAS,CAAC;AACrD,OAAK,aAAa,KAAK,KAAK,WAAW,YAAY;;;CAIrD,eAAuB;AACrB,SAAO,KAAK,KAAK,WAAW,GAAG,WAAW,CAAC,KAAK;;;CAIlD,YAAoB;EAClB,MAAM,YAAY,KAAK,cAAc;AACrC,MAAI,WAAW,UAAU,CACvB,QAAO,aAAa,WAAW,QAAQ;AAEzC,SAAO;;;CAIT,YAAY,SAAuB;EACjC,MAAM,YAAY,KAAK,cAAc;EACrC,IAAI;AAEJ,MAAI,WAAW,UAAU,CAEvB,gBADiB,aAAa,WAAW,QAAQ,GACvB,OAAO;MAEjC,gBAAe,KAAK,WAAW,CAAC,MAAM;AAGxC,gBAAc,WAAW,cAAc,QAAQ;;;CAIjD,eAAuB;AACrB,MAAI,WAAW,KAAK,WAAW,CAC7B,QAAO,aAAa,KAAK,YAAY,QAAQ;AAE/C,SAAO;;;CAIT,cAAc,SAAuB;AACnC,gBAAc,KAAK,YAAY,SAAS,QAAQ;;;CAIlD,kBAAkB,OAAO,GAAW;EAClC,MAAM,WAAqB,EAAE;EAC7B,MAAM,wBAAQ,IAAI,MAAM;AAExB,OAAK,IAAI,IAAI,GAAG,IAAI,MAAM,KAAK;GAC7B,MAAM,OAAO,IAAI,KAAK,MAAM;AAC5B,QAAK,QAAQ,KAAK,SAAS,GAAG,EAAE;GAChC,MAAM,UAAU,KAAK,aAAa,CAAC,MAAM,GAAG,GAAG;GAC/C,MAAM,WAAW,KAAK,KAAK,WAAW,GAAG,QAAQ,KAAK;AAEtD,OAAI,WAAW,SAAS,CACtB,UAAS,KAAK,aAAa,UAAU,QAAQ,CAAC;;AAIlD,SAAO,SAAS,KAAK,cAAc;;;CAIrC,kBAA4B;AAC1B,MAAI,CAAC,WAAW,KAAK,UAAU,CAAE,QAAO,EAAE;AAE1C,SAAO,YAAY,KAAK,UAAU,CAC/B,QAAQ,MAAM,0BAA0B,KAAK,EAAE,CAAC,CAChD,MAAM,CACN,SAAS,CACT,KAAK,MAAM,KAAK,KAAK,WAAW,EAAE,CAAC;;;CAIxC,mBAA2B;EACzB,MAAM,QAAkB,EAAE;EAE1B,MAAM,WAAW,KAAK,cAAc;AACpC,MAAI,SACF,OAAM,KAAK,0BAA0B,SAAS;EAGhD,MAAM,QAAQ,KAAK,WAAW;AAC9B,MAAI,MACF,OAAM,KAAK,uBAAuB,MAAM;AAG1C,SAAO,MAAM,KAAK,OAAO"}

package/dist/agent/skills.d.mts

@@ -0,0 +1,43 @@
+//#region src/agent/skills.d.ts
+interface SkillInfo {
+  name: string;
+  path: string;
+  source: "workspace" | "builtin";
+}
+interface SkillMeta {
+  description?: string;
+  always?: string;
+  metadata?: string;
+  [key: string]: string | undefined;
+}
+/**
+ * Loader for agent skills.
+ * Skills are markdown files (SKILL.md) that teach the agent specific capabilities.
+ */
+declare class SkillsLoader {
+  private workspace;
+  private workspaceSkills;
+  private builtinSkills;
+  constructor(workspace: string, builtinSkillsDir?: string);
+  /** List all available skills. */
+  listSkills(filterUnavailable?: boolean): SkillInfo[];
+  /** Load a skill by name. */
+  loadSkill(name: string): string | null;
+  /** Load specific skills for inclusion in agent context. */
+  loadSkillsForContext(skillNames: string[]): string;
+  /** Build a summary of all skills. */
+  buildSkillsSummary(): string;
+  /** Get skills marked as always=true. */
+  getAlwaysSkills(): string[];
+  /** Get metadata from a skill's frontmatter. */
+  getSkillMetadata(name: string): SkillMeta | null;
+  private stripFrontmatter;
+  private parseNanobotMetadata;
+  private checkRequirements;
+  private getSkillMeta;
+  private getSkillDescription;
+  private getMissingRequirements;
+}
+//#endregion
+export { SkillsLoader };
+//# sourceMappingURL=skills.d.mts.map

package/dist/agent/skills.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.mts","names":[],"sources":["../../src/agent/skills.ts"],"mappings":";UAWU,SAAA;EACR,IAAA;EACA,IAAA;EACA,MAAA;AAAA;AAAA,UAGQ,SAAA;EACR,WAAA;EACA,MAAA;EACA,QAAA;EAAA,CACC,GAAA;AAAA;;;;;cAOU,YAAA;EAAA,QACH,SAAA;EAAA,QACA,eAAA;EAAA,QACA,aAAA;cAEI,SAAA,UAAmB,gBAAA;EALpB;EAYX,UAAA,CAAW,iBAAA,aAA2B,SAAA;;EAsCtC,SAAA,CAAU,IAAA;EAjDF;EAgER,oBAAA,CAAqB,UAAA;EA9Db;EA2ER,kBAAA,CAAA;EAzEY;EA0GZ,eAAA,CAAA;EAnGA;EAgHA,gBAAA,CAAiB,IAAA,WAAe,SAAA;EAAA,QAsBxB,gBAAA;EAAA,QAQA,oBAAA;EAAA,QAWA,iBAAA;EAAA,QAWA,YAAA;EAAA,QAKA,mBAAA;EAAA,QAKA,sBAAA;AAAA"}

package/dist/agent/skills.mjs

@@ -0,0 +1,159 @@
+import { which } from "../utils/which.mjs";
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { dirname, join } from "node:path";
+
+//#region src/agent/skills.ts
+/** Default builtin skills directory (relative to this file in dist). */
+function getBuiltinSkillsDir() {
+	return join(dirname(dirname(__dirname)), "skills");
+}
+/**
+* Loader for agent skills.
+* Skills are markdown files (SKILL.md) that teach the agent specific capabilities.
+*/
+var SkillsLoader = class {
+	workspace;
+	workspaceSkills;
+	builtinSkills;
+	constructor(workspace, builtinSkillsDir) {
+		this.workspace = workspace;
+		this.workspaceSkills = join(workspace, "skills");
+		this.builtinSkills = builtinSkillsDir ?? getBuiltinSkillsDir();
+	}
+	/** List all available skills. */
+	listSkills(filterUnavailable = true) {
+		const skills = [];
+		if (existsSync(this.workspaceSkills)) for (const entry of readdirSync(this.workspaceSkills)) {
+			const skillDir = join(this.workspaceSkills, entry);
+			const skillFile = join(skillDir, "SKILL.md");
+			if (statSync(skillDir).isDirectory() && existsSync(skillFile)) skills.push({
+				name: entry,
+				path: skillFile,
+				source: "workspace"
+			});
+		}
+		if (existsSync(this.builtinSkills)) for (const entry of readdirSync(this.builtinSkills)) {
+			const skillDir = join(this.builtinSkills, entry);
+			const skillFile = join(skillDir, "SKILL.md");
+			if (statSync(skillDir).isDirectory() && existsSync(skillFile) && !skills.some((s) => s.name === entry)) skills.push({
+				name: entry,
+				path: skillFile,
+				source: "builtin"
+			});
+		}
+		if (filterUnavailable) return skills.filter((s) => this.checkRequirements(this.getSkillMeta(s.name)));
+		return skills;
+	}
+	/** Load a skill by name. */
+	loadSkill(name) {
+		const wsSkill = join(this.workspaceSkills, name, "SKILL.md");
+		if (existsSync(wsSkill)) return readFileSync(wsSkill, "utf-8");
+		const builtinSkill = join(this.builtinSkills, name, "SKILL.md");
+		if (existsSync(builtinSkill)) return readFileSync(builtinSkill, "utf-8");
+		return null;
+	}
+	/** Load specific skills for inclusion in agent context. */
+	loadSkillsForContext(skillNames) {
+		const parts = [];
+		for (const name of skillNames) {
+			const content = this.loadSkill(name);
+			if (content) {
+				const stripped = this.stripFrontmatter(content);
+				parts.push(`### Skill: ${name}\n\n${stripped}`);
+			}
+		}
+		return parts.join("\n\n---\n\n");
+	}
+	/** Build a summary of all skills. */
+	buildSkillsSummary() {
+		const allSkills = this.listSkills(false);
+		if (allSkills.length === 0) return "";
+		const escapeXml = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+		const lines = ["<skills>"];
+		for (const s of allSkills) {
+			const name = escapeXml(s.name);
+			const desc = escapeXml(this.getSkillDescription(s.name));
+			const meta = this.getSkillMeta(s.name);
+			const available = this.checkRequirements(meta);
+			lines.push(`  <skill available="${available}">`);
+			lines.push(`    <name>${name}</name>`);
+			lines.push(`    <description>${desc}</description>`);
+			lines.push(`    <location>${s.path}</location>`);
+			if (!available) {
+				const missing = this.getMissingRequirements(meta);
+				if (missing) lines.push(`    <requires>${escapeXml(missing)}</requires>`);
+			}
+			lines.push("  </skill>");
+		}
+		lines.push("</skills>");
+		return lines.join("\n");
+	}
+	/** Get skills marked as always=true. */
+	getAlwaysSkills() {
+		const result = [];
+		for (const s of this.listSkills(true)) {
+			const meta = this.getSkillMetadata(s.name);
+			if (this.parseNanobotMetadata(meta?.metadata ?? "").always || meta?.always) result.push(s.name);
+		}
+		return result;
+	}
+	/** Get metadata from a skill's frontmatter. */
+	getSkillMetadata(name) {
+		const content = this.loadSkill(name);
+		if (!content) return null;
+		if (content.startsWith("---")) {
+			const match = content.match(/^---\n([\s\S]*?)\n---/);
+			if (match) {
+				const metadata = {};
+				for (const line of match[1].split("\n")) {
+					const colonIdx = line.indexOf(":");
+					if (colonIdx !== -1) {
+						const key = line.slice(0, colonIdx).trim();
+						metadata[key] = line.slice(colonIdx + 1).trim().replace(/^["']|["']$/g, "");
+					}
+				}
+				return metadata;
+			}
+		}
+		return null;
+	}
+	stripFrontmatter(content) {
+		if (content.startsWith("---")) {
+			const match = content.match(/^---\n[\s\S]*?\n---\n/);
+			if (match) return content.slice(match[0].length).trim();
+		}
+		return content;
+	}
+	parseNanobotMetadata(raw) {
+		try {
+			const data = JSON.parse(raw);
+			return typeof data === "object" && data !== null ? data.nanobot ?? {} : {};
+		} catch {
+			return {};
+		}
+	}
+	checkRequirements(meta) {
+		const requires = meta.requires ?? {};
+		for (const bin of requires.bins ?? []) if (!which(bin)) return false;
+		for (const env of requires.env ?? []) if (!process.env[env]) return false;
+		return true;
+	}
+	getSkillMeta(name) {
+		const meta = this.getSkillMetadata(name) ?? {};
+		return this.parseNanobotMetadata(String(meta.metadata ?? ""));
+	}
+	getSkillDescription(name) {
+		return this.getSkillMetadata(name)?.description ?? name;
+	}
+	getMissingRequirements(meta) {
+		const missing = [];
+		const requires = meta.requires ?? {};
+		for (const bin of requires.bins ?? []) if (!which(bin)) missing.push(`CLI: ${bin}`);
+		for (const env of requires.env ?? []) if (!process.env[env]) missing.push(`ENV: ${env}`);
+		return missing.join(", ");
+	}
+};
+
+//#endregion
+export { SkillsLoader };
+//# sourceMappingURL=skills.mjs.map

package/dist/agent/skills.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.mjs","names":[],"sources":["../../src/agent/skills.ts"],"sourcesContent":["import { readFileSync, existsSync, readdirSync, statSync } from \"node:fs\";\nimport { join, dirname } from \"node:path\";\nimport { which } from \"../utils/which.js\";\n\n/** Default builtin skills directory (relative to this file in dist). */\nfunction getBuiltinSkillsDir(): string {\n  // In dist: dist/agent/skills.js -> ../../skills\n  // In src: src/agent/skills.ts -> ../../skills\n  return join(dirname(dirname(__dirname)), \"skills\");\n}\n\ninterface SkillInfo {\n  name: string;\n  path: string;\n  source: \"workspace\" | \"builtin\";\n}\n\ninterface SkillMeta {\n  description?: string;\n  always?: string;\n  metadata?: string;\n  [key: string]: string | undefined;\n}\n\n/**\n * Loader for agent skills.\n * Skills are markdown files (SKILL.md) that teach the agent specific capabilities.\n */\nexport class SkillsLoader {\n  private workspace: string;\n  private workspaceSkills: string;\n  private builtinSkills: string;\n\n  constructor(workspace: string, builtinSkillsDir?: string) {\n    this.workspace = workspace;\n    this.workspaceSkills = join(workspace, \"skills\");\n    this.builtinSkills = builtinSkillsDir ?? getBuiltinSkillsDir();\n  }\n\n  /** List all available skills. */\n  listSkills(filterUnavailable = true): SkillInfo[] {\n    const skills: SkillInfo[] = [];\n\n    // Workspace skills (highest priority)\n    if (existsSync(this.workspaceSkills)) {\n      for (const entry of readdirSync(this.workspaceSkills)) {\n        const skillDir = join(this.workspaceSkills, entry);\n        const skillFile = join(skillDir, \"SKILL.md\");\n        if (statSync(skillDir).isDirectory() && existsSync(skillFile)) {\n          skills.push({ name: entry, path: skillFile, source: \"workspace\" });\n        }\n      }\n    }\n\n    // Built-in skills\n    if (existsSync(this.builtinSkills)) {\n      for (const entry of readdirSync(this.builtinSkills)) {\n        const skillDir = join(this.builtinSkills, entry);\n        const skillFile = join(skillDir, \"SKILL.md\");\n        if (\n          statSync(skillDir).isDirectory() &&\n          existsSync(skillFile) &&\n          !skills.some((s) => s.name === entry)\n        ) {\n          skills.push({ name: entry, path: skillFile, source: \"builtin\" });\n        }\n      }\n    }\n\n    if (filterUnavailable) {\n      return skills.filter((s) =>\n        this.checkRequirements(this.getSkillMeta(s.name)),\n      );\n    }\n    return skills;\n  }\n\n  /** Load a skill by name. */\n  loadSkill(name: string): string | null {\n    const wsSkill = join(this.workspaceSkills, name, \"SKILL.md\");\n    if (existsSync(wsSkill)) {\n      return readFileSync(wsSkill, \"utf-8\");\n    }\n\n    const builtinSkill = join(this.builtinSkills, name, \"SKILL.md\");\n    if (existsSync(builtinSkill)) {\n      return readFileSync(builtinSkill, \"utf-8\");\n    }\n\n    return null;\n  }\n\n  /** Load specific skills for inclusion in agent context. */\n  loadSkillsForContext(skillNames: string[]): string {\n    const parts: string[] = [];\n    for (const name of skillNames) {\n      const content = this.loadSkill(name);\n      if (content) {\n        const stripped = this.stripFrontmatter(content);\n        parts.push(`### Skill: ${name}\\n\\n${stripped}`);\n      }\n    }\n    return parts.join(\"\\n\\n---\\n\\n\");\n  }\n\n  /** Build a summary of all skills. */\n  buildSkillsSummary(): string {\n    const allSkills = this.listSkills(false);\n    if (allSkills.length === 0) return \"\";\n\n    const escapeXml = (s: string) =>\n      s.replace(/&/g, \"&amp;\").replace(/</g, \"&lt;\").replace(/>/g, \"&gt;\");\n\n    const lines = [\"<skills>\"];\n    for (const s of allSkills) {\n      const name = escapeXml(s.name);\n      const desc = escapeXml(this.getSkillDescription(s.name));\n      const meta = this.getSkillMeta(s.name);\n      const available = this.checkRequirements(meta);\n\n      lines.push(`  <skill available=\"${available}\">`);\n      lines.push(`    <name>${name}</name>`);\n      lines.push(`    <description>${desc}</description>`);\n      lines.push(`    <location>${s.path}</location>`);\n\n      if (!available) {\n        const missing = this.getMissingRequirements(meta);\n        if (missing) {\n          lines.push(`    <requires>${escapeXml(missing)}</requires>`);\n        }\n      }\n\n      lines.push(\"  </skill>\");\n    }\n    lines.push(\"</skills>\");\n    return lines.join(\"\\n\");\n  }\n\n  /** Get skills marked as always=true. */\n  getAlwaysSkills(): string[] {\n    const result: string[] = [];\n    for (const s of this.listSkills(true)) {\n      const meta = this.getSkillMetadata(s.name);\n      const skillMeta = this.parseNanobotMetadata(meta?.metadata ?? \"\");\n      if (skillMeta.always || meta?.always) {\n        result.push(s.name);\n      }\n    }\n    return result;\n  }\n\n  /** Get metadata from a skill's frontmatter. */\n  getSkillMetadata(name: string): SkillMeta | null {\n    const content = this.loadSkill(name);\n    if (!content) return null;\n\n    if (content.startsWith(\"---\")) {\n      const match = content.match(/^---\\n([\\s\\S]*?)\\n---/);\n      if (match) {\n        const metadata: SkillMeta = {};\n        for (const line of match[1].split(\"\\n\")) {\n          const colonIdx = line.indexOf(\":\");\n          if (colonIdx !== -1) {\n            const key = line.slice(0, colonIdx).trim();\n            const value = line.slice(colonIdx + 1).trim().replace(/^[\"']|[\"']$/g, \"\");\n            metadata[key] = value;\n          }\n        }\n        return metadata;\n      }\n    }\n    return null;\n  }\n\n  private stripFrontmatter(content: string): string {\n    if (content.startsWith(\"---\")) {\n      const match = content.match(/^---\\n[\\s\\S]*?\\n---\\n/);\n      if (match) return content.slice(match[0].length).trim();\n    }\n    return content;\n  }\n\n  private parseNanobotMetadata(raw: string): Record<string, unknown> {\n    try {\n      const data = JSON.parse(raw);\n      return typeof data === \"object\" && data !== null\n        ? (data.nanobot ?? {})\n        : {};\n    } catch {\n      return {};\n    }\n  }\n\n  private checkRequirements(meta: Record<string, unknown>): boolean {\n    const requires = (meta.requires ?? {}) as Record<string, string[]>;\n    for (const bin of requires.bins ?? []) {\n      if (!which(bin)) return false;\n    }\n    for (const env of requires.env ?? []) {\n      if (!process.env[env]) return false;\n    }\n    return true;\n  }\n\n  private getSkillMeta(name: string): Record<string, unknown> {\n    const meta = this.getSkillMetadata(name) ?? {};\n    return this.parseNanobotMetadata(String(meta.metadata ?? \"\"));\n  }\n\n  private getSkillDescription(name: string): string {\n    const meta = this.getSkillMetadata(name);\n    return meta?.description ?? name;\n  }\n\n  private getMissingRequirements(meta: Record<string, unknown>): string {\n    const missing: string[] = [];\n    const requires = (meta.requires ?? {}) as Record<string, string[]>;\n    for (const bin of requires.bins ?? []) {\n      if (!which(bin)) missing.push(`CLI: ${bin}`);\n    }\n    for (const env of requires.env ?? []) {\n      if (!process.env[env]) missing.push(`ENV: ${env}`);\n    }\n    return missing.join(\", \");\n  }\n}\n"],"mappings":"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"}

package/dist/agent/subagent.d.mts

@@ -0,0 +1,39 @@
+import { LLMProvider } from "../providers/base.mjs";
+import { MessageBus } from "../bus/queue.mjs";
+import { ExecToolConfig } from "../config/schema.mjs";
+
+//#region src/agent/subagent.d.ts
+/**
+ * Manages background subagent execution.
+ */
+declare class SubagentManager {
+  private provider;
+  private workspace;
+  private bus;
+  private model;
+  private braveApiKey?;
+  private execConfig;
+  private runningTasks;
+  constructor(params: {
+    provider: LLMProvider;
+    workspace: string;
+    bus: MessageBus;
+    model?: string;
+    braveApiKey?: string;
+    execConfig?: ExecToolConfig;
+  });
+  /** Spawn a subagent to execute a task in the background. */
+  spawn(params: {
+    task: string;
+    label?: string;
+    originChannel?: string;
+    originChatId?: string;
+  }): Promise<string>;
+  private runSubagent;
+  private announceResult;
+  private buildSubagentPrompt;
+  get runningCount(): number;
+}
+//#endregion
+export { SubagentManager };
+//# sourceMappingURL=subagent.d.mts.map

package/dist/agent/subagent.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent.d.mts","names":[],"sources":["../../src/agent/subagent.ts"],"mappings":";;;;;;;AAaA;cAAa,eAAA;EAAA,QACH,QAAA;EAAA,QACA,SAAA;EAAA,QACA,GAAA;EAAA,QACA,KAAA;EAAA,QACA,WAAA;EAAA,QACA,UAAA;EAAA,QACA,YAAA;cAEI,MAAA;IACV,QAAA,EAAU,WAAA;IACV,SAAA;IACA,GAAA,EAAK,UAAA;IACL,KAAA;IACA,WAAA;IACA,UAAA,GAAa,cAAA;EAAA;EALb;EAgBI,KAAA,CAAM,MAAA;IACV,IAAA;IACA,KAAA;IACA,aAAA;IACA,YAAA;EAAA,IACE,OAAA;EAAA,QAwBU,WAAA;EAAA,QA2FA,cAAA;EAAA,QA8BN,mBAAA;EAAA,IA+BJ,YAAA,CAAA;AAAA"}