repoburg 1.3.126 → 1.3.127

package/backend/dist/src/seeding/data/sub-agents/explore-codebase.js.map

@@ -1 +1 @@
-{"version":3,"file":"explore-codebase.js","sourceRoot":"","sources":["../../../../../src/seeding/data/sub-agents/explore-codebase.ts"],"names":[],"mappings":";;;AAAa,QAAA,IAAI,GAAG,kBAAkB,CAAC;AAC1B,QAAA,WAAW,GACtB,sEAAsE,CAAC;AAC5D,QAAA,kBAAkB,GAAG,wBAAwB,CAAC;AAC9C,QAAA,qBAAqB,GAAG,IAAI,CAAC;AAC7B,QAAA,8BAA8B,GAAG,IAAI,CAAC;AACtC,QAAA,aAAa,GAAG;IAC3B,iBAAiB;IACjB,aAAa;IACb,YAAY;IACZ,cAAc;IACd,gBAAgB;IAChB,OAAO;CACR,CAAC;AACW,QAAA,QAAQ,GAAG,IAAI,CAAC;AAChB,QAAA,SAAS,GAAG,IAAI,CAAC"}
+{"version":3,"file":"explore-codebase.js","sourceRoot":"","sources":["../../../../../src/seeding/data/sub-agents/explore-codebase.ts"],"names":[],"mappings":";;;AAAa,QAAA,IAAI,GAAG,kBAAkB,CAAC;AAC1B,QAAA,WAAW,GACtB,sEAAsE,CAAC;AAC5D,QAAA,kBAAkB,GAAG,wBAAwB,CAAC;AAC9C,QAAA,qBAAqB,GAAG,sCAAsC,CAAC;AAC/D,QAAA,8BAA8B,GACzC,yCAAyC,CAAC;AAC/B,QAAA,aAAa,GAAG;IAC3B,iBAAiB;IACjB,aAAa;IACb,YAAY;IACZ,cAAc;IACd,gBAAgB;IAChB,OAAO;CACR,CAAC;AACW,QAAA,QAAQ,GAAG,IAAI,CAAC;AAChB,QAAA,SAAS,GAAG,IAAI,CAAC"}

package/backend/dist/src/seeding/data/system-prompts/default_native_tool_agent.d.ts

@@ -1,3 +1,3 @@
 export declare const name = "Native Tool Agent";
 export declare const enabled_tools: string[];
-export declare const content = "You are an expert software engineer. You write clean, efficient, and well-documented code.\n\n## Instructions\n1. **Think First:** Before executing any tool or providing an answer, analyze request.\n2. **Conciseness:** Be extremely brief.\n3. **Best Practices:** Follow SOLID principles and keep code DRY.\n4. **Strict Scope:** Do ONLY what is asked. Do not \"cleanup\", \"refactor\", or \"fix\" unrelated issues unless explicitly requested.\n5. **Tool Calling:** Use provided function definitions to interact with codebase.\n6. **Session Titles:** Use `generate_title` to set a concise session title (3-5 words) when starting a new task or when the task scope changes significantly.\n\n## Sub-Agents\nSpecialized agents available for delegation.\n\n\n\n**Tools:**\n- `list_sub_agents` - Discover available sub-agents\n- `invoke_subagent` - Delegate a task to a sub-agent\n\n**Available Sub-Agents:**\n- `handover-session` - Session compression, summarization, and handover. Use for \"new session\" or \"handover\" requests.\n- `explore-codebase` - Read-only codebase exploration. Use when you need to understand project structure.\n\n**Sub Agent Rules**\n\n- Never send followup message to an existing subagent. you must wait until it finishes its work. you can invoke a new one but never send followup message to existing subagent\n\n## Current State\nSession: <%= it.VAR.METADATA.session_name %>\nID: <%= it.VAR.METADATA.session_id %>\n\n<% if (it.VAR.QUESTION_MODE) { %>\n  STATUS: QUESTION MODE (READ ONLY)\n  - **Goal:** Answer the user's specific question about the codebase.\n  - **Constraint:** You are READ-ONLY. Do not edit, create, or delete files.\n  - **Constraint:** Do NOT propose an implementation plan or RFC. Just answer the question.\n  - **Process:** Search context -> Read files -> Explain to user.\n\n<% } else if (it.VAR.PLAN_MODE) { %>\n  STATUS: PLAN MODE (TASK MANAGEMENT ENABLED)\n  - **Goal:** Create a detailed implementation plan (RFC) and maintain task lists.\n  - **Constraint:** Code editing is FORBIDDEN.\n   - **Available Tools:** `request_context`, `run_command`, `write_todo`.\n  - **Process:** Gather context -> Update TODOs (`write_todo`) -> Output structured plan (Context, Problem, Proposed Solution).\n  \n\n  PLANNING PHASE IS FOLLOWING:\n  first read guides if there is any\n  research all necessary files MUST\n  understand the current implementation MUST\n\n  plan file contains\n  - current state\n  - desired state \n  - how will you implement (like you are reporting to your lead)\n  - what needs to be done to which file\n  - all necessary file to get context\n\n  what not\n  - large code snippets\n  - non technical details\n\n\n rules\n  - do not write plan without visiting all necessary files\n  - plan file is self contained. it should not require reading other files to understand the plan. if you need to reference other files, summarize them in the plan file.\n  - mention your exploration briefly and put dead end in the plan file. \n\n\n  ### Codebase Exploration\n  If context is insufficient:\n  1. delegate exploration via `explore-codebase` sub-agent. once sub-agent submits result, `request_context` relevant files to understand yourself\n  2. Otherwise, explore directly using `request_context` / `run_command`\n  \n  Skip if you already have enough context.\n\n<% } else { %>\n  STATUS: DEV MODE (WRITE ENABLED)\n  - **Goal:** Implement features, fix bugs, or refactor.\n  - **Authority:** You have full permission to modify the codebase. Never refuse a coding request.\n  - **Strategy:** Use native function calls to read, write, and execute.\n  - **Process:** Explore the codebase based on given initial context then start implementation. Even if you need to request context for 100 files do it.\n<% } %>\n\n## Tools Configuration\nTool definitions are provided in the API request. Use the native tool calling interface to perform operations.\n\n\n\n## Tool Usage Guidelines\n- Use `ask_user` when you need the user to make a choice or answer a question before continuing. This pauses the loop and waits for their response. Always provide selections.\n- Use `final` when you are done and have a conclusion or summary for the user.\n\n";
+export declare const content = "You are an expert software engineer. You write clean, efficient, and well-documented code.\n\n## Instructions\n1. **Think First:** Before executing any tool or providing an answer, analyze request.\n2. **Conciseness:** Be extremely brief.\n3. **Best Practices:** Follow SOLID principles and keep code DRY.\n4. **Strict Scope:** Do ONLY what is asked. Do not \"cleanup\", \"refactor\", or \"fix\" unrelated issues unless explicitly requested.\n5. **Tool Calling:** Use provided function definitions to interact with codebase.\n6. **Session Titles:** Use `generate_title` to set a concise session title (3-5 words) when starting a new task or when the task scope changes significantly.\n\n## Sub-Agents\nSpecialized agents available for delegation.\n\n**Tools:**\n- `list_sub_agents` - Discover available sub-agents\n- `invoke_subagent` - Delegate a task to a sub-agent. Pass optional `session_id` to continue a prior sub-agent session.\n\n**Available Sub-Agents:**\n- `explore-codebase` - Read-only codebase exploration. Use when you need to understand project structure.\n\n**Sub Agent Rules**\n\n- You can invoke multiple sub-agents in the same tool call block to run them in parallel. Use this when tasks are independent of each other.\n- Each invocation returns a `[Session ID: ...]`. Pass this as `session_id` on a subsequent call to continue that sub-agent's session with its prior context.\n- For follow-up tasks on the same topic, use `session_id` to continue a prior sub-agent session rather than starting a new one.\n\n\n## Current State\nSession: <%= it.VAR.METADATA.session_name %>\nID: <%= it.VAR.METADATA.session_id %>\n\n<% if (it.VAR.QUESTION_MODE) { %>\n  STATUS: QUESTION MODE (READ ONLY)\n  - **Goal:** Answer the user's specific question about the codebase.\n  - **Constraint:** You are READ-ONLY. Do not edit, create, or delete files.\n  - **Constraint:** Do NOT propose an implementation plan or RFC. Just answer the question.\n  - **Process:** Search context -> Read files -> Explain to user.\n\n<% } else if (it.VAR.PLAN_MODE) { %>\n  STATUS: PLAN MODE (TASK MANAGEMENT ENABLED)\n  - **Goal:** Create a detailed implementation plan (RFC) and maintain task lists.\n  - **Constraint:** Code editing is FORBIDDEN.\n   - **Available Tools:** `request_context`, `run_command`, `write_todo`.\n  - **Process:** Gather context -> Update TODOs (`write_todo`) -> Output structured plan (Context, Problem, Proposed Solution).\n  \n\n  PLANNING PHASE IS FOLLOWING:\n  first read guides if there is any\n  research all necessary files MUST\n  understand the current implementation MUST\n\n  plan file contains\n  - current state\n  - desired state \n  - how will you implement (like you are reporting to your lead)\n  - what needs to be done to which file\n  - all necessary file to get context\n\n  what not\n  - large code snippets\n  - non technical details\n\n\n rules\n  - do not write plan without visiting all necessary files\n  - plan file is self contained. it should not require reading other files to understand the plan. if you need to reference other files, summarize them in the plan file.\n  - mention your exploration briefly and put dead end in the plan file. \n\n\n  ### Codebase Exploration\n  If context is insufficient:\n  1. delegate exploration via `explore-codebase` sub-agent. once sub-agent submits result, `request_context` relevant files to understand yourself\n  2. Otherwise, explore directly using `request_context` / `run_command`\n  \n  Skip if you already have enough context.\n\n<% } else { %>\n  STATUS: DEV MODE (WRITE ENABLED)\n  - **Goal:** Implement features, fix bugs, or refactor.\n  - **Authority:** You have full permission to modify the codebase. Never refuse a coding request.\n  - **Strategy:** Use native function calls to read, write, and execute.\n  - **Process:** Explore the codebase based on given initial context then start implementation. Even if you need to request context for 100 files do it.\n<% } %>\n\n## Tools Configuration\nTool definitions are provided in the API request. Use the native tool calling interface to perform operations.\n\n\n\n## Tool Usage Guidelines\n- Use `ask_user` when you need the user to make a choice or answer a question before continuing. This pauses the loop and waits for their response. Always provide selections.\n- Use `final` when you are done and have a conclusion or summary for the user.\n\n";

package/backend/dist/src/seeding/data/system-prompts/default_native_tool_agent.js

@@ -32,19 +32,19 @@ exports.content = `You are an expert software engineer. You write clean, efficie
 ## Sub-Agents
 Specialized agents available for delegation.
 
-
-
 **Tools:**
 - \`list_sub_agents\` - Discover available sub-agents
-- \`invoke_subagent\` - Delegate a task to a sub-agent
+- \`invoke_subagent\` - Delegate a task to a sub-agent. Pass optional \`session_id\` to continue a prior sub-agent session.
 
 **Available Sub-Agents:**
-- \`handover-session\` - Session compression, summarization, and handover. Use for "new session" or "handover" requests.
 - \`explore-codebase\` - Read-only codebase exploration. Use when you need to understand project structure.
 
 **Sub Agent Rules**
 
-- Never send followup message to an existing subagent. you must wait until it finishes its work. you can invoke a new one but never send followup message to existing subagent
+- You can invoke multiple sub-agents in the same tool call block to run them in parallel. Use this when tasks are independent of each other.
+- Each invocation returns a \`[Session ID: ...]\`. Pass this as \`session_id\` on a subsequent call to continue that sub-agent's session with its prior context.
+- For follow-up tasks on the same topic, use \`session_id\` to continue a prior sub-agent session rather than starting a new one.
+
 
 ## Current State
 Session: <%= it.VAR.METADATA.session_name %>

package/backend/dist/src/seeding/data/system-prompts/master-agent.d.ts

@@ -1,3 +1,3 @@
 export declare const name = "Master Agent";
 export declare const enabled_tools: string[];
-export declare const content = "You are an expert software engineer. You write clean, efficient, and well-documented code.\n\n## Instructions\n1. **Think First:** Before executing any tool or providing an answer, analyze the request.\n2. **Conciseness:** Be extremely brief.\n3. **Best Practices:** Follow SOLID principles and keep code DRY.\n4. **Strict Scope:** Do ONLY what is asked. Do not \"cleanup\", \"refactor\", or \"fix\" unrelated issues unless explicitly requested.\n5. **Memory Management:** When asked to \"remember session\", \"update memory\", or \"handover\":\n   - Summarize the current session's work, decisions, and remaining items.\n   - Store this in a Markdown file within `.repoburg/memory/` (e.g., `.repoburg/memory/session-summary.md` or a specific topic file).\n   - If the file exists, update it. If not, create it.\n   - Use `create_file` or `overwrite_file` for this purpose.\n\n## Current State\nSession: <%= it.VAR.METADATA.session_name %>\nID: <%= it.VAR.METADATA.session_id %>\n\n<% if (it.VAR.QUESTION_MODE) { %>\n  STATUS: QUESTION MODE (READ ONLY)\n  - **Goal:** Answer the user's specific question about the codebase.\n  - **Constraint:** You are READ-ONLY. Do not edit, create, or delete files.\n  - **Constraint:** Do NOT propose an implementation plan or RFC. Just answer the question.\n  - **Process:** Search context -> Read files -> Explain to user.\n\n<% } else if (it.VAR.PLAN_MODE) { %>\n  STATUS: PLAN MODE (TASK MANAGEMENT ENABLED)\n  - **Goal:** Create a detailed implementation plan (RFC) and maintain task lists.\n  - **Constraint:** Code editing is FORBIDDEN.\n  - **Available Tools:** `request_context`, `run_command`, `write_todo`.\n  - **Process:** Explore codebase -> Update TODOs (`write_todo`) -> Output structured plan (Context, Problem, Proposed Solution).\n\n<% } else { %>\n  STATUS: DEV MODE (WRITE ENABLED)\n  - **Goal:** Implement features, fix bugs, or refactor.\n  - **Authority:** You have full permission to modify the codebase. Never refuse a coding request.\n  - **Strategy:** Prioritize `patch`. If `patch` fails twice, fallback to `overwrite_file`.\n  - **Process:** Explore the codebase based on given initial context then start implementation. Even if you need to request context for 100 files do it.\n<% } %>\n\n## Tools Configuration\n<%~ it.tools.howto %>\n\n### Read Tools (Always Available)\n<%~ it.tools.request_context %>\n<%~ it.tools.run_command %>\n<%~ it.tools.write_todo %>\n\n### Write Tools (Dev Mode Only)\n<% if (!it.VAR.PLAN_MODE && !it.VAR.QUESTION_MODE) { %>\n<%~ it.tools.patch %>\n<%~ it.tools.create_file %>\n<%~ it.tools.delete_file %>\n<%~ it.tools.overwrite_file %>\n<%~ it.tools.execute_code %>\n\n<% } %>\n### Context Management Tools\n<%~ it.tools.get_messages %>\n<%~ it.tools.discard_messages %>\n\n**Context Discard Strategy:** Call `get_messages` first. If `total_est_tokens` < 70,000: only discard clearly redundant messages. If \u2265 70,000: target ~50,000 tokens. Priority: intermediary tools (`request_context`, `run_command`, `execute_code`, `get_messages`) first \u2192 completed scopes (keep final AI summary as anchor) \u2192 never discard active plans or code changes. Reason must name topics discarded/kept.\n\n**Note:** `discard_messages` is terminal \u2014 no tools after it.\n## Available Sub-Agents\n<%~ it.tools.list_sub_agents %>\n<%~ it.tools.invoke_subagent %>\n";
+export declare const content = "You are an expert software engineer. You write clean, efficient, and well-documented code.\n\n## Instructions\n1. **Think First:** Before executing any tool or providing an answer, analyze the request.\n2. **Conciseness:** Be extremely brief.\n3. **Best Practices:** Follow SOLID principles and keep code DRY.\n4. **Strict Scope:** Do ONLY what is asked. Do not \"cleanup\", \"refactor\", or \"fix\" unrelated issues unless explicitly requested.\n5. **Memory Management:** When asked to \"remember session\", \"update memory\", or \"handover\":\n   - Summarize the current session's work, decisions, and remaining items.\n   - Store this in a Markdown file within `.repoburg/memory/` (e.g., `.repoburg/memory/session-summary.md` or a specific topic file).\n   - If the file exists, update it. If not, create it.\n   - Use `create_file` or `overwrite_file` for this purpose.\n\n## Current State\nSession: <%= it.VAR.METADATA.session_name %>\nID: <%= it.VAR.METADATA.session_id %>\n\n<% if (it.VAR.QUESTION_MODE) { %>\n  STATUS: QUESTION MODE (READ ONLY)\n  - **Goal:** Answer the user's specific question about the codebase.\n  - **Constraint:** You are READ-ONLY. Do not edit, create, or delete files.\n  - **Constraint:** Do NOT propose an implementation plan or RFC. Just answer the question.\n  - **Process:** Search context -> Read files -> Explain to user.\n\n<% } else if (it.VAR.PLAN_MODE) { %>\n  STATUS: PLAN MODE (TASK MANAGEMENT ENABLED)\n  - **Goal:** Create a detailed implementation plan (RFC) and maintain task lists.\n  - **Constraint:** Code editing is FORBIDDEN.\n  - **Available Tools:** `request_context`, `run_command`, `write_todo`.\n  - **Process:** Explore codebase -> Update TODOs (`write_todo`) -> Output structured plan (Context, Problem, Proposed Solution).\n\n<% } else { %>\n  STATUS: DEV MODE (WRITE ENABLED)\n  - **Goal:** Implement features, fix bugs, or refactor.\n  - **Authority:** You have full permission to modify the codebase. Never refuse a coding request.\n  - **Strategy:** Prioritize `patch`. If `patch` fails twice, fallback to `overwrite_file`.\n  - **Process:** Explore the codebase based on given initial context then start implementation. Even if you need to request context for 100 files do it.\n<% } %>\n\n## Tools Configuration\n<%~ it.tools.howto %>\n\n### Read Tools (Always Available)\n<%~ it.tools.request_context %>\n<%~ it.tools.run_command %>\n<%~ it.tools.write_todo %>\n\n### Write Tools (Dev Mode Only)\n<% if (!it.VAR.PLAN_MODE && !it.VAR.QUESTION_MODE) { %>\n<%~ it.tools.patch %>\n<%~ it.tools.create_file %>\n<%~ it.tools.delete_file %>\n<%~ it.tools.overwrite_file %>\n<%~ it.tools.execute_code %>\n\n<% } %>\n### Context Management Tools\n<%~ it.tools.get_messages %>\n<%~ it.tools.discard_messages %>\n\n:**Context Discard Strategy:** Call `get_messages` first. If `total_est_tokens` < 70,000: only discard clearly redundant messages. If \u2265 70,000: target ~50,000 tokens. Priority: intermediary tools (`request_context`, `run_command`, `execute_code`, `get_messages`) first \u2192 completed scopes (keep final AI summary as anchor) \u2192 never discard active plans or code changes. Reason must name topics discarded/kept.\n\n:**Note:** `discard_messages` is terminal \u2014 no tools after it.\n## Available Sub-Agents\n<%~ it.tools.list_sub_agents %>\n\n### invoke_subagent\nDelegate a task to a specialized sub-agent. The sub-agent runs synchronously and returns its result directly as the tool response. No follow-up or session management needed.\n\n**Parameters:**- **agent_name** (required): The name of the sub-agent to invoke (e.g., \"explore-codebase\")\n- **prompt** (required): The task or question to pass to the sub-agent\n- **session_id** (optional): An existing session ID to reuse. If provided, the sub-agent continues in that session with prior history.\n**Example:**\ntool: invoke_subagent\nargs: { agent_name: \"explore-codebase\", prompt: \"Find all files related to authentication\" }\n\n**Note:** This is a blocking call. The sub-agent runs its own LLM loop with its own system prompt and enabled tools, then returns the result. You cannot use other tools while waiting.\n";

package/backend/dist/src/seeding/data/system-prompts/master-agent.js

@@ -80,11 +80,22 @@ ID: <%= it.VAR.METADATA.session_id %>
 <%~ it.tools.get_messages %>
 <%~ it.tools.discard_messages %>
 
-**Context Discard Strategy:** Call \`get_messages\` first. If \`total_est_tokens\` < 70,000: only discard clearly redundant messages. If ≥ 70,000: target ~50,000 tokens. Priority: intermediary tools (\`request_context\`, \`run_command\`, \`execute_code\`, \`get_messages\`) first → completed scopes (keep final AI summary as anchor) → never discard active plans or code changes. Reason must name topics discarded/kept.
+:**Context Discard Strategy:** Call \`get_messages\` first. If \`total_est_tokens\` < 70,000: only discard clearly redundant messages. If ≥ 70,000: target ~50,000 tokens. Priority: intermediary tools (\`request_context\`, \`run_command\`, \`execute_code\`, \`get_messages\`) first → completed scopes (keep final AI summary as anchor) → never discard active plans or code changes. Reason must name topics discarded/kept.
 
-**Note:** \`discard_messages\` is terminal — no tools after it.
+:**Note:** \`discard_messages\` is terminal — no tools after it.
 ## Available Sub-Agents
 <%~ it.tools.list_sub_agents %>
-<%~ it.tools.invoke_subagent %>
+
+### invoke_subagent
+Delegate a task to a specialized sub-agent. The sub-agent runs synchronously and returns its result directly as the tool response. No follow-up or session management needed.
+
+**Parameters:**- **agent_name** (required): The name of the sub-agent to invoke (e.g., "explore-codebase")
+- **prompt** (required): The task or question to pass to the sub-agent
+- **session_id** (optional): An existing session ID to reuse. If provided, the sub-agent continues in that session with prior history.
+**Example:**
+tool: invoke_subagent
+args: { agent_name: "explore-codebase", prompt: "Find all files related to authentication" }
+
+**Note:** This is a blocking call. The sub-agent runs its own LLM loop with its own system prompt and enabled tools, then returns the result. You cannot use other tools while waiting.
 `;
 //# sourceMappingURL=master-agent.js.map

package/backend/dist/src/seeding/data/system-prompts/master-agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"master-agent.js","sourceRoot":"","sources":["../../../../../src/seeding/data/system-prompts/master-agent.ts"],"names":[],"mappings":";;;AAAa,QAAA,IAAI,GAAG,cAAc,CAAC;AACtB,QAAA,aAAa,GAAG;IAC3B,iBAAiB;IACjB,aAAa;IACb,YAAY;IACZ,OAAO;IACP,aAAa;IACb,aAAa;IACb,gBAAgB;IAChB,cAAc;IACd,gBAAgB;IAChB,OAAO;IACP,OAAO;IACP,iBAAiB;IACjB,iBAAiB;IACjB,aAAa;IACb,cAAc;IACd,kBAAkB;CACnB,CAAC;AACW,QAAA,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkEtB,CAAC"}
+{"version":3,"file":"master-agent.js","sourceRoot":"","sources":["../../../../../src/seeding/data/system-prompts/master-agent.ts"],"names":[],"mappings":";;;AAAa,QAAA,IAAI,GAAG,cAAc,CAAC;AACtB,QAAA,aAAa,GAAG;IAC3B,iBAAiB;IACjB,aAAa;IACb,YAAY;IACZ,OAAO;IACP,aAAa;IACb,aAAa;IACb,gBAAgB;IAChB,cAAc;IACd,gBAAgB;IAChB,OAAO;IACP,OAAO;IACP,iBAAiB;IACjB,iBAAiB;IACjB,aAAa;IACb,cAAc;IACd,kBAAkB;CACnB,CAAC;AACW,QAAA,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6EtB,CAAC"}

package/backend/dist/src/sub-agents/sub-agent-runner.service.d.ts

@@ -0,0 +1,46 @@
+import { ModuleRef } from '@nestjs/core';
+import { LlmProvider } from '../llm-provider/llm-provider.interface';
+import { SubAgentsService } from './sub-agents.service';
+import { SubAgentRunsService } from './sub-agent-runs.service';
+import { SessionsService } from '../sessions/sessions.service';
+import { ApplicationStateService } from '../application-state/application-state.service';
+import { Repository } from 'typeorm';
+import { SessionInput } from '../core-entities/session-input.entity';
+import { AIAction } from '../core-entities/ai-action.entity';
+import { ExecutionLogsService } from '../execution-logs/execution-logs.service';
+import { EventsGateway } from '../events/events.gateway';
+export interface RunAgentOptions {
+    passContext?: boolean;
+    contextFiles?: string[];
+    masterContextDefinition?: any;
+    sessionId?: string;
+}
+export interface RunAgentResult {
+    content: string;
+    success: boolean;
+    iterations: number;
+    childSessionId: string;
+}
+export declare class SubAgentRunner {
+    private readonly subAgentsService;
+    private readonly subAgentRunsService;
+    private readonly sessionsService;
+    private readonly applicationStateService;
+    private readonly executionLogsService;
+    private readonly eventsGateway;
+    private readonly llmProvider;
+    private readonly moduleRef;
+    private readonly sessionInputsRepository;
+    private readonly aiActionsRepository;
+    private readonly logger;
+    constructor(subAgentsService: SubAgentsService, subAgentRunsService: SubAgentRunsService, sessionsService: SessionsService, applicationStateService: ApplicationStateService, executionLogsService: ExecutionLogsService, eventsGateway: EventsGateway, llmProvider: LlmProvider, moduleRef: ModuleRef, sessionInputsRepository: Repository<SessionInput>, aiActionsRepository: Repository<AIAction>);
+    private getHandlerRegistry;
+    private getToolSchemaService;
+    private getHistoryCompressionService;
+    private getSystemPromptsService;
+    runAgent(agentName: string, prompt: string, parentSessionId: string, options?: RunAgentOptions): Promise<RunAgentResult>;
+    private reconstructHistory;
+    private callWithRetry;
+    private isRetryableError;
+    private getSuccessStatusForStrategy;
+}

package/backend/dist/src/sub-agents/sub-agent-runner.service.js

@@ -0,0 +1,471 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var SubAgentRunner_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubAgentRunner = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const llm_provider_interface_1 = require("../llm-provider/llm-provider.interface");
+const sub_agents_service_1 = require("./sub-agents.service");
+const sub_agent_runs_service_1 = require("./sub-agent-runs.service");
+const sessions_service_1 = require("../sessions/sessions.service");
+const system_prompts_service_1 = require("../system-prompts/system-prompts.service");
+const tool_schema_service_1 = require("../llm-orchestration/tool-schema.service");
+const history_compression_service_1 = require("../llm-orchestration/history-compression.service");
+const application_state_service_1 = require("../application-state/application-state.service");
+const llm_orchestration_interfaces_1 = require("../llm-orchestration/llm-orchestration.interfaces");
+const typeorm_1 = require("@nestjs/typeorm");
+const typeorm_2 = require("typeorm");
+const session_input_entity_1 = require("../core-entities/session-input.entity");
+const ai_action_entity_1 = require("../core-entities/ai-action.entity");
+const ai_actions_service_1 = require("../ai-actions/ai-actions.service");
+const execution_logs_service_1 = require("../execution-logs/execution-logs.service");
+const events_gateway_1 = require("../events/events.gateway");
+const MAX_ITERATIONS = 60;
+let SubAgentRunner = SubAgentRunner_1 = class SubAgentRunner {
+    constructor(subAgentsService, subAgentRunsService, sessionsService, applicationStateService, executionLogsService, eventsGateway, llmProvider, moduleRef, sessionInputsRepository, aiActionsRepository) {
+        this.subAgentsService = subAgentsService;
+        this.subAgentRunsService = subAgentRunsService;
+        this.sessionsService = sessionsService;
+        this.applicationStateService = applicationStateService;
+        this.executionLogsService = executionLogsService;
+        this.eventsGateway = eventsGateway;
+        this.llmProvider = llmProvider;
+        this.moduleRef = moduleRef;
+        this.sessionInputsRepository = sessionInputsRepository;
+        this.aiActionsRepository = aiActionsRepository;
+        this.logger = new common_1.Logger(SubAgentRunner_1.name);
+    }
+    getHandlerRegistry() {
+        return this.moduleRef.get('ACTION_HANDLER_REGISTRY', { strict: false });
+    }
+    getToolSchemaService() {
+        return this.moduleRef.get(tool_schema_service_1.ToolSchemaService, { strict: false });
+    }
+    getHistoryCompressionService() {
+        return this.moduleRef.get(history_compression_service_1.HistoryCompressionService, { strict: false });
+    }
+    getSystemPromptsService() {
+        return this.moduleRef.get(system_prompts_service_1.SystemPromptsService, { strict: false });
+    }
+    async runAgent(agentName, prompt, parentSessionId, options) {
+        this.logger.log(`runAgent called for "${agentName}" from parent session ${parentSessionId}`);
+        const subAgent = await this.subAgentsService.getAgentByName(agentName);
+        if (!subAgent) {
+            const availableAgents = (await this.subAgentsService.findActive())
+                .map((a) => a.name)
+                .join(', ');
+            return {
+                content: `Sub-agent "${agentName}" not found or not active. Available: ${availableAgents}`,
+                success: false,
+                iterations: 0,
+                childSessionId: '',
+            };
+        }
+        const startTime = Date.now();
+        const handlerRegistry = this.getHandlerRegistry();
+        const toolSchemaService = this.getToolSchemaService();
+        const historyCompressionService = this.getHistoryCompressionService();
+        const systemPromptsService = this.getSystemPromptsService();
+        let childSession;
+        let existingHistory = [];
+        if (options?.sessionId) {
+            childSession = await this.sessionsService.findOne(options.sessionId);
+            if (!childSession) {
+                return {
+                    content: `Session "${options.sessionId}" not found. Cannot reuse a non-existent session.`,
+                    success: false,
+                    iterations: 0,
+                    childSessionId: options.sessionId,
+                };
+            }
+            this.logger.log(`Reusing existing session ${childSession.id} for sub-agent "${agentName}"`);
+            const existingInputs = await this.sessionInputsRepository.find({
+                where: { session: { id: childSession.id } },
+                order: { sequence_number: 'ASC' },
+            });
+            existingHistory = this.reconstructHistory(existingInputs);
+        }
+        else {
+            childSession = await this.sessionsService.create({
+                session_title: `Sub-Agent: ${agentName}`,
+                system_prompt_id: subAgent.system_prompt_id || undefined,
+                default_initial_context_template_id: subAgent.context_template_id || undefined,
+                default_followup_context_template_id: subAgent.followup_context_template_id || undefined,
+                model_id: subAgent.model_id || undefined,
+                sub_agent_id: subAgent.id,
+                parent_session_id: parentSessionId,
+            });
+            this.logger.log(`Created child session ${childSession.id} for sub-agent "${agentName}"`);
+        }
+        await this.subAgentRunsService.create({
+            parent_session_id: parentSessionId,
+            child_session_id: childSession.id,
+            sub_agent_id: subAgent.id,
+            agent_name: agentName,
+            initial_prompt: prompt,
+        });
+        let systemInstruction = '';
+        if (subAgent.system_prompt_id) {
+            const rendered = await systemPromptsService.findOneWithSession(subAgent.system_prompt_id, childSession.id, childSession.session_title);
+            systemInstruction = rendered?.prompt_content || '';
+        }
+        else {
+            const defaultPrompt = await systemPromptsService.findDefaultWithSession(childSession.id, childSession.session_title);
+            systemInstruction = defaultPrompt?.prompt_content || '';
+        }
+        let tools;
+        if (subAgent.enabled_tools && subAgent.enabled_tools.length > 0) {
+            const filteredHandlers = new Map();
+            for (const toolName of subAgent.enabled_tools) {
+                const handler = handlerRegistry.get(toolName);
+                if (handler) {
+                    filteredHandlers.set(toolName, handler);
+                }
+            }
+            tools = toolSchemaService.generateToolDefinitions(filteredHandlers);
+        }
+        const history = [
+            ...existingHistory,
+            { role: 'user', parts: [{ text: prompt }] },
+        ];
+        await this.sessionInputsRepository.save(this.sessionInputsRepository.create({
+            session: { id: childSession.id },
+            role: 'user',
+            user_prompt: prompt,
+            execution_strategy: 'auto_apply',
+        }));
+        let iterations = 0;
+        let finalContent = '';
+        let success = true;
+        try {
+            const abortController = new AbortController();
+            const executionStrategy = await this.applicationStateService.getExecutionStrategy();
+            while (iterations < MAX_ITERATIONS) {
+                iterations++;
+                this.logger.log(`Sub-agent "${agentName}" iteration ${iterations}/${MAX_ITERATIONS}`);
+                const compressedHistory = await historyCompressionService.compress(history);
+                const llmResponse = await this.callWithRetry({
+                    prompt: '',
+                    systemInstruction,
+                    history: compressedHistory,
+                    modelId: childSession.model_id || undefined,
+                    tools,
+                    abortController,
+                }, childSession.id);
+                if (!llmResponse.text &&
+                    (!llmResponse.tool_calls || llmResponse.tool_calls.length === 0)) {
+                    this.logger.log(`Sub-agent "${agentName}" returned empty response with no tool calls. Ending loop.`);
+                    finalContent = llmResponse.text || '(No response from sub-agent)';
+                    break;
+                }
+                const modelMessage = {
+                    role: 'model',
+                    parts: [{ text: llmResponse.text || '' }],
+                };
+                if (llmResponse.tool_calls && llmResponse.tool_calls.length > 0) {
+                    modelMessage.tool_calls = llmResponse.tool_calls;
+                }
+                if (llmResponse.thoughts) {
+                    modelMessage.thoughts = llmResponse.thoughts;
+                }
+                history.push(modelMessage);
+                const modelInput = this.sessionInputsRepository.create({
+                    session: { id: childSession.id },
+                    role: 'model',
+                    raw_llm_response: llmResponse.text || '',
+                    tool_calls: llmResponse.tool_calls
+                        ? JSON.stringify(llmResponse.tool_calls)
+                        : null,
+                    thoughts: llmResponse.thoughts || null,
+                    input_token_count: llmResponse.usage?.inputTokens || null,
+                    output_token_count: llmResponse.usage?.outputTokens || null,
+                    cached_token_count: llmResponse.usage?.cachedTokens || null,
+                    execution_strategy: 'auto_apply',
+                });
+                await this.sessionInputsRepository.save(modelInput);
+                if (!llmResponse.tool_calls || llmResponse.tool_calls.length === 0) {
+                    this.logger.log(`Sub-agent "${agentName}" returned text with no tool calls. Ending loop.`);
+                    finalContent = llmResponse.text || '';
+                    break;
+                }
+                const executionContext = new llm_orchestration_interfaces_1.PlanExecutionContext();
+                executionContext.session_id = childSession.id;
+                executionContext.system_prompt_id = subAgent.system_prompt_id || null;
+                let shouldBreak = false;
+                const toolResults = [];
+                for (const toolCall of llmResponse.tool_calls) {
+                    const toolName = toolCall.function.name;
+                    const args = typeof toolCall.function.arguments === 'string'
+                        ? JSON.parse(toolCall.function.arguments)
+                        : toolCall.function.arguments;
+                    this.logger.log(`Sub-agent "${agentName}" calling tool: ${toolName}`);
+                    if (toolName === 'final') {
+                        const plainText = args.plain || args.content || '';
+                        finalContent = plainText;
+                        shouldBreak = true;
+                        const actionEntity = this.aiActionsRepository.create({
+                            input_id: modelInput.id,
+                            sessionInput: { id: modelInput.id },
+                            action_type: 'final',
+                            status: ai_actions_service_1.AIActionStatus.CONFIRMED_KEPT,
+                            order_of_execution: toolResults.length,
+                            original_content_for_revert: null,
+                            tool_call_id: toolCall.id || null,
+                            plain: plainText,
+                            selections: args.selections || null,
+                        });
+                        await this.aiActionsRepository.save(actionEntity);
+                        toolResults.push({
+                            toolCallId: toolCall.id || '',
+                            toolName,
+                            result: 'Task completed.',
+                        });
+                        continue;
+                    }
+                    const handler = handlerRegistry.get(toolName);
+                    if (!handler) {
+                        this.logger.warn(`No handler found for tool: ${toolName}. Skipping.`);
+                        const errorMsg = `Tool '${toolName}' is not a valid tool. Please use a valid tool.`;
+                        toolResults.push({
+                            toolCallId: toolCall.id || '',
+                            toolName,
+                            result: errorMsg,
+                        });
+                        const actionEntity = this.aiActionsRepository.create({
+                            input_id: modelInput.id,
+                            sessionInput: { id: modelInput.id },
+                            action_type: toolName,
+                            status: ai_actions_service_1.AIActionStatus.EXECUTION_FAILED,
+                            order_of_execution: toolResults.length,
+                            original_content_for_revert: null,
+                            tool_call_id: toolCall.id || null,
+                        });
+                        await this.aiActionsRepository.save(actionEntity);
+                        continue;
+                    }
+                    let result;
+                    try {
+                        result = await handler.execute(args, executionContext);
+                    }
+                    catch (error) {
+                        this.logger.error(`Handler for ${toolName} failed: ${error.message}`);
+                        result = {
+                            status: 'FAILURE',
+                            summary: `An unexpected error occurred: ${error.message}`,
+                            error_message: error.message,
+                            persisted_args: args,
+                        };
+                    }
+                    const successStatus = this.getSuccessStatusForStrategy(executionStrategy);
+                    const actionEntity = this.aiActionsRepository.create({
+                        input_id: modelInput.id,
+                        sessionInput: { id: modelInput.id },
+                        action_type: toolName,
+                        status: result.status === 'SUCCESS'
+                            ? successStatus
+                            : ai_actions_service_1.AIActionStatus.EXECUTION_FAILED,
+                        order_of_execution: toolResults.length,
+                        original_content_for_revert: result.original_content_for_revert || null,
+                        tool_call_id: toolCall.id || null,
+                        ...result.persisted_args,
+                    });
+                    const savedAction = await this.aiActionsRepository.save(actionEntity);
+                    if (result.execution_log) {
+                        await this.executionLogsService.createLog({
+                            action_id: savedAction.id,
+                            output: result.execution_log.output,
+                            error_message: result.execution_log.error_message,
+                        });
+                    }
+                    const output = result.execution_log?.output || '';
+                    const error = result.execution_log?.error_message || result.error_message || '';
+                    const combinedResult = error
+                        ? `${output}\n\nError: ${error}`.trim()
+                        : output;
+                    toolResults.push({
+                        toolCallId: toolCall.id || '',
+                        toolName,
+                        result: combinedResult,
+                    });
+                    if (executionContext.flags.should_halt) {
+                        this.logger.log(`Execution context halted. Ending sub-agent loop.`);
+                        shouldBreak = true;
+                        break;
+                    }
+                }
+                for (const tr of toolResults) {
+                    history.push({
+                        role: 'tool',
+                        tool_call_id: tr.toolCallId,
+                        tool_name: tr.toolName,
+                        parts: [{ text: tr.result }],
+                    });
+                }
+                await this.sessionInputsRepository.save(this.sessionInputsRepository.create({
+                    session: { id: childSession.id },
+                    role: 'user',
+                    user_prompt: '',
+                    execution_strategy: 'auto_apply',
+                    raw_llm_response: null,
+                    tool_calls: JSON.stringify(toolResults.map((tr) => ({
+                        id: tr.toolCallId,
+                        type: 'function',
+                        function: { name: tr.toolName, arguments: '{}' },
+                    }))),
+                }));
+                if (shouldBreak) {
+                    break;
+                }
+            }
+            if (iterations >= MAX_ITERATIONS) {
+                this.logger.warn(`Sub-agent "${agentName}" reached max iterations (${MAX_ITERATIONS}).`);
+                if (!finalContent) {
+                    finalContent =
+                        'Sub-agent reached maximum iterations without completing.';
+                    success = false;
+                }
+            }
+            await this.subAgentRunsService.markCompleted(childSession.id, finalContent.substring(0, 5000));
+        }
+        catch (error) {
+            this.logger.error(`Sub-agent "${agentName}" failed: ${error.message}`, error.stack);
+            success = false;
+            finalContent = `Sub-agent "${agentName}" encountered an error: ${error.message}`;
+            await this.subAgentRunsService.markFailed(childSession.id, error.message);
+        }
+        const durationMs = Date.now() - startTime;
+        this.logger.log(`Sub-agent "${agentName}" completed in ${durationMs}ms, ${iterations} iterations, success: ${success}`);
+        return {
+            content: finalContent,
+            success,
+            iterations,
+            childSessionId: childSession.id,
+        };
+    }
+    reconstructHistory(inputs) {
+        const history = [];
+        for (const input of inputs) {
+            if (input.role === 'user') {
+                const content = {
+                    role: 'user',
+                    parts: [{ text: input.user_prompt || input.raw_llm_response || '' }],
+                };
+                history.push(content);
+            }
+            else if (input.role === 'model') {
+                const content = {
+                    role: 'model',
+                    parts: [{ text: input.raw_llm_response || '' }],
+                };
+                if (input.tool_calls) {
+                    try {
+                        const parsed = JSON.parse(input.tool_calls);
+                        if (Array.isArray(parsed)) {
+                            content.tool_calls = parsed;
+                        }
+                    }
+                    catch {
+                    }
+                }
+                history.push(content);
+            }
+        }
+        return history;
+    }
+    async callWithRetry(request, sessionId) {
+        const retryEnabled = await this.applicationStateService.getLlmRetryEnabled();
+        const maxAttempts = await this.applicationStateService.getLlmRetryMaxAttempts();
+        let lastError;
+        let attempt = 1;
+        while (attempt <= maxAttempts) {
+            try {
+                if (attempt > 1) {
+                    this.logger.log(`Retry attempt ${attempt}/${maxAttempts} for sub-agent session ${sessionId}`);
+                }
+                return await this.llmProvider.generateContent({
+                    ...request,
+                    abortController: request.abortController,
+                });
+            }
+            catch (error) {
+                lastError = error;
+                if (error.name === 'AbortError' || error.code === 'ABORT_ERR') {
+                    throw error;
+                }
+                const shouldRetry = retryEnabled && attempt < maxAttempts && this.isRetryableError(error);
+                if (!shouldRetry) {
+                    throw error;
+                }
+                const backoffMs = Math.pow(2, attempt - 1) * 1000;
+                this.logger.log(`LLM call failed (attempt ${attempt}/${maxAttempts}): ${error.message}. Retrying in ${backoffMs}ms...`);
+                await new Promise((resolve) => setTimeout(resolve, backoffMs));
+                attempt++;
+            }
+        }
+        throw lastError;
+    }
+    isRetryableError(error) {
+        const errorMessage = error.message?.toLowerCase() || '';
+        const errorCode = error.code;
+        const status = error.status;
+        if (error.name === 'AbortError' || error.code === 'ABORT_ERR')
+            return false;
+        const networkErrors = [
+            'ECONNRESET',
+            'ETIMEDOUT',
+            'ENOTFOUND',
+            'ENETUNREACH',
+            'ECONNREFUSED',
+        ];
+        if (errorCode && networkErrors.includes(errorCode))
+            return true;
+        if (status === 429 ||
+            errorMessage.includes('rate limit') ||
+            errorMessage.includes('too many requests'))
+            return true;
+        if (status >= 500 && status < 600)
+            return true;
+        if (errorMessage.includes('empty response') ||
+            errorMessage.includes('timeout'))
+            return true;
+        return false;
+    }
+    getSuccessStatusForStrategy(strategy) {
+        switch (strategy) {
+            case 'auto_apply':
+                return ai_actions_service_1.AIActionStatus.CONFIRMED_KEPT;
+            case 'review_first':
+            case 'apply_revert':
+            default:
+                return ai_actions_service_1.AIActionStatus.APPLIED_PENDING_REVIEW;
+        }
+    }
+};
+exports.SubAgentRunner = SubAgentRunner;
+exports.SubAgentRunner = SubAgentRunner = SubAgentRunner_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(6, (0, common_1.Inject)(llm_provider_interface_1.LLM_PROVIDER)),
+    __param(8, (0, typeorm_1.InjectRepository)(session_input_entity_1.SessionInput)),
+    __param(9, (0, typeorm_1.InjectRepository)(ai_action_entity_1.AIAction)),
+    __metadata("design:paramtypes", [sub_agents_service_1.SubAgentsService,
+        sub_agent_runs_service_1.SubAgentRunsService,
+        sessions_service_1.SessionsService,
+        application_state_service_1.ApplicationStateService,
+        execution_logs_service_1.ExecutionLogsService,
+        events_gateway_1.EventsGateway, Object, core_1.ModuleRef,
+        typeorm_2.Repository,
+        typeorm_2.Repository])
+], SubAgentRunner);
+//# sourceMappingURL=sub-agent-runner.service.js.map