sub-agents-mcp 0.1.5 → 0.2.0

package/README.md

@@ -25,7 +25,9 @@ Claude Code offers powerful sub-agent workflows—but they're limited to its own
 - [Usage Examples](#usage-examples)
 - [Agent Examples](#agent-examples)
 - [Configuration Reference](#configuration-reference)
+- [Session Management](#session-management)
 - [Troubleshooting](#troubleshooting)
+- [Design Philosophy](#design-philosophy)
 - [How It Works](#how-it-works)
 
 ## Prerequisites
@@ -237,6 +239,78 @@ Example with timeout:
 
 Agents have access to your project directory. Only use agent definitions from trusted sources.
 
+## Session Management
+
+Session management allows sub-agents to remember previous executions, which helps when you want agents to build on earlier work or maintain context across multiple calls.
+
+### Why Sessions Matter
+
+By default, each sub-agent execution starts with no context. With sessions enabled:
+- Agents can reference their earlier work
+- You get execution history for debugging
+- Related tasks share context
+
+### Enabling Sessions
+
+Add these environment variables to your MCP configuration:
+
+```json
+{
+  "mcpServers": {
+    "sub-agents": {
+      "command": "npx",
+      "args": ["-y", "sub-agents-mcp"],
+      "env": {
+        "AGENTS_DIR": "/absolute/path/to/agents",
+        "AGENT_TYPE": "cursor",
+        "SESSION_ENABLED": "true",
+        "SESSION_DIR": "/absolute/path/to/session-storage",
+        "SESSION_RETENTION_DAYS": "7"
+      }
+    }
+  }
+}
+```
+
+**Configuration options:**
+
+- `SESSION_ENABLED` - Set to `"true"` to enable session management (default: `false`)
+- `SESSION_DIR` - Where to store session files (default: `.mcp-sessions` in the current working directory)
+- `SESSION_RETENTION_DAYS` - How long to keep session history in days (default: 7)
+
+**Security consideration:** Session files contain execution history and may include sensitive information. Use absolute paths for `SESSION_DIR`.
+
+### When to Use Sessions
+
+Sessions work well for:
+- **Iterative development**: "Based on your earlier findings, now fix the issues"
+- **Multi-step workflows**: Breaking complex tasks into smaller sub-agent calls
+- **Debugging**: Reviewing exactly what was executed and what results were returned
+
+Note that sessions require additional storage and processing overhead.
+
+### How Session Continuity Works
+
+When sessions are enabled, the MCP response includes a `session_id` field. To continue the same session, pass this ID back in the next request.
+
+**Important:** Your AI assistant must explicitly include the session_id in subsequent requests. While some assistants may do this automatically, it's not guaranteed. For reliable session continuity, add explicit instructions to your prompts or project rules.
+
+**Example prompt instruction:**
+```markdown
+When using sub-agents with sessions enabled, always include the session_id
+from the previous response in your next request to maintain context.
+```
+
+**Example project rule (e.g., `AGENTS.md`):**
+```markdown
+# Sub-Agent Session Guidelines
+
+When calling the same sub-agent multiple times:
+1. Extract the session_id from the MCP response
+2. Pass it as a parameter in subsequent calls
+3. This preserves context between executions
+```
+
 ## Troubleshooting
 
 ### Timeout errors or authentication failures
@@ -265,6 +339,29 @@ Check that:
 2. Ensure your chosen CLI tool is installed and accessible
 3. Double-check that all environment variables are set in the MCP config
 
+## Design Philosophy
+
+### Why Independent Contexts Matter
+
+Every sub-agent starts with a fresh context. This adds some startup overhead for each call, but it ensures that every task runs independently and without leftover state from previous runs.
+
+**Context Isolation**
+- Each agent only receives the information relevant to its task
+- No context leakage between runs
+- The main agent stays focused and lightweight
+
+**Accuracy and Reliability**
+- Sub-agents can specialize in a single goal without interference
+- Less risk of confusion from unrelated context
+- More consistent results in complex, multi-step workflows
+
+**Scalability**
+- Large tasks can be safely split into smaller sub-tasks
+- Each sub-agent operates within its own token limit
+- The main agent coordinates without hitting global context limits
+
+The startup overhead is an intentional trade-off: the system favors clarity and accuracy over raw execution speed.
+
 ## How It Works
 
 This MCP server acts as a bridge between your AI tool and a supported execution engine (Cursor CLI or Claude Code CLI).

package/dist/config/ServerConfig.d.ts

@@ -10,6 +10,9 @@
  * - AGENTS_DIR: Directory containing agent definition files (REQUIRED - must be absolute path)
  * - AGENT_TYPE: Type of agent to use ('cursor' | 'claude') (default: 'cursor')
  * - LOG_LEVEL: Log level for server operations (default: 'info')
+ * - SESSION_ENABLED: Enable session management functionality (default: false)
+ * - SESSION_DIR: Directory for storing session files (default: '.mcp-sessions')
+ * - SESSION_RETENTION_DAYS: Number of days to retain session files (default: 1)
  */
 export declare class ServerConfig {
     /** Server name identifier used for MCP registration */
@@ -24,6 +27,12 @@ export declare class ServerConfig {
     readonly logLevel: 'debug' | 'info' | 'warn' | 'error';
     /** Maximum execution timeout in milliseconds for agent execution */
     readonly executionTimeoutMs: number;
+    /** Enable session management functionality */
+    readonly sessionEnabled: boolean;
+    /** Directory for storing session files */
+    readonly sessionDir: string;
+    /** Number of days to retain session files before cleanup */
+    readonly sessionRetentionDays: number;
     /**
      * Creates a new ServerConfig instance by loading values from environment variables
      * or using default values.

package/dist/config/ServerConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ServerConfig.d.ts","sourceRoot":"","sources":["../../src/config/ServerConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,qBAAa,YAAY;IACvB,uDAAuD;IACvD,SAAgB,UAAU,EAAE,MAAM,CAAA;IAElC,6CAA6C;IAC7C,SAAgB,aAAa,EAAE,MAAM,CAAA;IAErC,gEAAgE;IAChE,SAAgB,SAAS,EAAE,MAAM,CAAA;IAEjC,yCAAyC;IACzC,SAAgB,SAAS,EAAE,QAAQ,GAAG,QAAQ,CAAA;IAE9C,sCAAsC;IACtC,SAAgB,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;IAE7D,oEAAoE;IACpE,SAAgB,kBAAkB,EAAE,MAAM,CAAA;IAE1C;;;;OAIG;;CAkCJ"}
+{"version":3,"file":"ServerConfig.d.ts","sourceRoot":"","sources":["../../src/config/ServerConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,YAAY;IACvB,uDAAuD;IACvD,SAAgB,UAAU,EAAE,MAAM,CAAA;IAElC,6CAA6C;IAC7C,SAAgB,aAAa,EAAE,MAAM,CAAA;IAErC,gEAAgE;IAChE,SAAgB,SAAS,EAAE,MAAM,CAAA;IAEjC,yCAAyC;IACzC,SAAgB,SAAS,EAAE,QAAQ,GAAG,QAAQ,CAAA;IAE9C,sCAAsC;IACtC,SAAgB,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;IAE7D,oEAAoE;IACpE,SAAgB,kBAAkB,EAAE,MAAM,CAAA;IAE1C,8CAA8C;IAC9C,SAAgB,cAAc,EAAE,OAAO,CAAA;IAEvC,0CAA0C;IAC1C,SAAgB,UAAU,EAAE,MAAM,CAAA;IAElC,4DAA4D;IAC5D,SAAgB,oBAAoB,EAAE,MAAM,CAAA;IAE5C;;;;OAIG;;CAiDJ"}

package/dist/config/ServerConfig.js

@@ -13,6 +13,9 @@ exports.ServerConfig = void 0;
  * - AGENTS_DIR: Directory containing agent definition files (REQUIRED - must be absolute path)
  * - AGENT_TYPE: Type of agent to use ('cursor' | 'claude') (default: 'cursor')
  * - LOG_LEVEL: Log level for server operations (default: 'info')
+ * - SESSION_ENABLED: Enable session management functionality (default: false)
+ * - SESSION_DIR: Directory for storing session files (default: '.mcp-sessions')
+ * - SESSION_RETENTION_DAYS: Number of days to retain session files (default: 1)
  */
 class ServerConfig {
     /**
@@ -48,6 +51,20 @@ class ServerConfig {
         else {
             this.executionTimeoutMs = 300000;
         }
+        // Session management configuration
+        // Only 'true' string enables session management, all other values are treated as false
+        this.sessionEnabled = process.env['SESSION_ENABLED'] === 'true';
+        this.sessionDir = process.env['SESSION_DIR'] || '.mcp-sessions';
+        // Parse SESSION_RETENTION_DAYS with validation (must be positive integer)
+        const retentionDaysEnv = process.env['SESSION_RETENTION_DAYS'];
+        if (retentionDaysEnv?.trim()) {
+            const parsedDays = Number.parseInt(retentionDaysEnv, 10);
+            // Use default (1 day) for invalid values (NaN, zero, or negative)
+            this.sessionRetentionDays = Number.isNaN(parsedDays) || parsedDays <= 0 ? 1 : parsedDays;
+        }
+        else {
+            this.sessionRetentionDays = 1;
+        }
     }
 }
 exports.ServerConfig = ServerConfig;

package/dist/config/ServerConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"ServerConfig.js","sourceRoot":"","sources":["../../src/config/ServerConfig.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;GAYG;AACH,MAAa,YAAY;IAmBvB;;;;OAIG;IACH;QACE,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,gBAAgB,CAAA;QAChE,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,OAAO,CAAA;QAE7D,mDAAmD;QACnD,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;QAC3C,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,gDAAgD;gBAC9C,gEAAgE;gBAChE,gDAAgD;gBAChD,cAAc;gBACd,8DAA8D;gBAC9D,OAAO;gBACP,+BAA+B;gBAC/B,cAAc;gBACd,qDAAqD;gBACrD,KAAK,CACR,CAAA;QACH,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAE1B,IAAI,CAAC,SAAS,GAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAyB,IAAI,QAAQ,CAAA;QAC/E,IAAI,CAAC,QAAQ,GAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAyC,IAAI,MAAM,CAAA;QAE3F,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAA;QACtD,IAAI,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC;YACvB,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAA;YACrD,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAA;QAChF,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAA;QAClC,CAAC;IACH,CAAC;CACF;AAzDD,oCAyDC"}
+{"version":3,"file":"ServerConfig.js","sourceRoot":"","sources":["../../src/config/ServerConfig.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAa,YAAY;IA4BvB;;;;OAIG;IACH;QACE,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,gBAAgB,CAAA;QAChE,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,OAAO,CAAA;QAE7D,mDAAmD;QACnD,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;QAC3C,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,gDAAgD;gBAC9C,gEAAgE;gBAChE,gDAAgD;gBAChD,cAAc;gBACd,8DAA8D;gBAC9D,OAAO;gBACP,+BAA+B;gBAC/B,cAAc;gBACd,qDAAqD;gBACrD,KAAK,CACR,CAAA;QACH,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAE1B,IAAI,CAAC,SAAS,GAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAyB,IAAI,QAAQ,CAAA;QAC/E,IAAI,CAAC,QAAQ,GAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAyC,IAAI,MAAM,CAAA;QAE3F,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAA;QACtD,IAAI,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC;YACvB,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAA;YACrD,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAA;QAChF,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAA;QAClC,CAAC;QAED,mCAAmC;QACnC,uFAAuF;QACvF,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,KAAK,MAAM,CAAA;QAC/D,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,eAAe,CAAA;QAE/D,0EAA0E;QAC1E,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAA;QAC9D,IAAI,gBAAgB,EAAE,IAAI,EAAE,EAAE,CAAC;YAC7B,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAA;YACxD,kEAAkE;YAClE,IAAI,CAAC,oBAAoB,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAA;QAC1F,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,oBAAoB,GAAG,CAAC,CAAA;QAC/B,CAAC;IACH,CAAC;CACF;AAjFD,oCAiFC"}

package/dist/server/McpServer.d.ts

@@ -31,6 +31,7 @@ export declare class McpServer {
     private agentExecutor;
     private runAgentTool;
     private agentResources;
+    private sessionManager?;
     /**
      * Create a new MCP server instance
      * @param config Server configuration object

package/dist/server/McpServer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"McpServer.d.ts","sourceRoot":"","sources":["../../src/server/McpServer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAeH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAO3D;;GAEG;AACH,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAOD;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,cAAc,CAAgB;IAEtC;;;;OAIG;gBACS,MAAM,EAAE,YAAY;IA+ChC;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAStB;;;;;OAKG;IACH,OAAO,CAAC,GAAG;IAqBX;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAuIrB;;;OAGG;IACH,aAAa,IAAI,UAAU;IAO3B;;;OAGG;IACH,YAAY,IAAI,OAAO;IAIvB;;;OAGG;IACH,OAAO,IAAI,OAAO;IAIlB;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B5B;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAU9F;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IASzF;;;;;OAKG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAOnE;;;;OAIG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOjD;;;;OAIG;IACH,cAAc,IAAI;QAChB,UAAU,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAA;QAC7C,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,IAAI,CAAA;SAAE,CAAC,CAAA;KAClF;IAOD;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAuB7B"}
+{"version":3,"file":"McpServer.d.ts","sourceRoot":"","sources":["../../src/server/McpServer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAeH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAQ3D;;GAEG;AACH,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAOD;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,cAAc,CAAC,CAAgB;IAEvC;;;;OAIG;gBACS,MAAM,EAAE,YAAY;IA+DhC;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAStB;;;;;OAKG;IACH,OAAO,CAAC,GAAG;IAqBX;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAuIrB;;;OAGG;IACH,aAAa,IAAI,UAAU;IAO3B;;;OAGG;IACH,YAAY,IAAI,OAAO;IAIvB;;;OAGG;IACH,OAAO,IAAI,OAAO;IAIlB;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B5B;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAU9F;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IASzF;;;;;OAKG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAOnE;;;;OAIG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOjD;;;;OAIG;IACH,cAAc,IAAI;QAChB,UAAU,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAA;QAC7C,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,IAAI,CAAA;SAAE,CAAC,CAAA;KAClF;IAOD;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAuB7B"}

package/dist/server/McpServer.js

@@ -21,6 +21,7 @@ const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
 const AgentManager_1 = require("../agents/AgentManager");
 const AgentExecutor_1 = require("../execution/AgentExecutor");
 const AgentResources_1 = require("../resources/AgentResources");
+const SessionManager_1 = require("../session/SessionManager");
 const RunAgentTool_1 = require("../tools/RunAgentTool");
 const ErrorHandler_1 = require("../utils/ErrorHandler");
 const Logger_1 = require("../utils/Logger");
@@ -50,7 +51,22 @@ class McpServer {
         // Create logger with log level from config
         const executorLogger = new Logger_1.Logger(config.logLevel);
         this.agentExecutor = new AgentExecutor_1.AgentExecutor(executionConfig, executorLogger);
-        this.runAgentTool = new RunAgentTool_1.RunAgentTool(this.agentExecutor, this.agentManager);
+        // Initialize SessionManager if session management is enabled
+        if (config.sessionEnabled) {
+            this.sessionManager = new SessionManager_1.SessionManager({
+                enabled: config.sessionEnabled,
+                sessionDir: config.sessionDir,
+                retentionDays: config.sessionRetentionDays,
+            });
+            this.log('info', 'Session management enabled', {
+                sessionDir: config.sessionDir,
+                retentionDays: config.sessionRetentionDays,
+            });
+        }
+        else {
+            this.log('info', 'Session management disabled');
+        }
+        this.runAgentTool = new RunAgentTool_1.RunAgentTool(this.agentExecutor, this.agentManager, this.sessionManager);
         this.agentResources = new AgentResources_1.AgentResources(this.agentManager);
         // Initialize MCP server with capabilities
         this.server = new index_js_1.Server({

package/dist/server/McpServer.js.map

@@ -1 +1 @@
-{"version":3,"file":"McpServer.js","sourceRoot":"","sources":["../../src/server/McpServer.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAEH,wEAAkE;AAClE,wEAAgF;AAChF,iEAS2C;AAC3C,0DAAsD;AAEtD,+DAAkF;AAClF,iEAA6D;AAC7D,yDAAqD;AACrD,yDAAkE;AAClE,6CAAyC;AAezC;;GAEG;AACH,MAAa,SAAS;IASpB;;;;OAIG;IACH,YAAY,MAAoB;QAZxB,cAAS,GAAgC,IAAI,CAAA;QAanD,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAA;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QAEpB,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,yBAAyB,EAAE;YAC1C,IAAI,EAAE,MAAM,CAAC,UAAU;YACvB,OAAO,EAAE,MAAM,CAAC,aAAa;SAC9B,CAAC,CAAA;QAEF,yCAAyC;QACzC,IAAI,CAAC,YAAY,GAAG,IAAI,2BAAY,CAAC,MAAM,CAAC,CAAA;QAE5C,gEAAgE;QAChE,MAAM,eAAe,GAAG,IAAA,qCAAqB,EAAC,MAAM,CAAC,SAAS,EAAE;YAC9D,gBAAgB,EAAE,MAAM,CAAC,kBAAkB,EAAE,mDAAmD;SACjG,CAAC,CAAA;QAEF,2CAA2C;QAC3C,MAAM,cAAc,GAAG,IAAI,eAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QAElD,IAAI,CAAC,aAAa,GAAG,IAAI,6BAAa,CAAC,eAAe,EAAE,cAAc,CAAC,CAAA;QACvE,IAAI,CAAC,YAAY,GAAG,IAAI,2BAAY,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,YAAY,CAAC,CAAA;QAC3E,IAAI,CAAC,cAAc,GAAG,IAAI,+BAAc,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QAE3D,0CAA0C;QAC1C,IAAI,CAAC,MAAM,GAAG,IAAI,iBAAM,CACtB;YACE,IAAI,EAAE,MAAM,CAAC,UAAU;YACvB,OAAO,EAAE,MAAM,CAAC,aAAa;SAC9B,EACD;YACE,YAAY,EAAE;gBACZ,KAAK,EAAE,EAAE;gBACT,SAAS,EAAE,EAAE;aACd;SACF,CACF,CAAA;QAED,4DAA4D;QAC5D,IAAI,CAAC,cAAc,EAAE,CAAA;QAErB,qBAAqB;QACrB,IAAI,CAAC,aAAa,EAAE,CAAA;QAEpB,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,qCAAqC,CAAC,CAAA;IACzD,CAAC;IAED;;;;OAIG;IACK,cAAc,CAAC,MAAoB;QACzC,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAA;QAChD,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAChE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAA;QACnD,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACK,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,QAAkC;QAC9E,MAAM,SAAS,GAA6B;YAC1C,KAAK,EAAE,CAAC;YACR,IAAI,EAAE,CAAC;YACP,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,CAAC;SACT,CAAA;QAED,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxD,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;YAC1C,MAAM,QAAQ,GAAG;gBACf,SAAS;gBACT,KAAK;gBACL,OAAO;gBACP,OAAO,EAAE,YAAY;gBACrB,GAAG,QAAQ;aACZ,CAAA;YACD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAA;QACzC,CAAC;IACH,CAAC;IAED;;OAEG;IACK,cAAc;QACpB,IAAI,CAAC;YACH,IAAI,CAAC,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAA;YAC3C,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,8CAA8C,CAAC,CAAA;QACnE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,2BAA2B,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;YACxE,MAAM,IAAI,uBAAQ,CAAC,+BAA+B,EAAE,wBAAwB,CAAC,CAAA;QAC/E,CAAC;IACH,CAAC;IAED;;OAEG;IACK,aAAa;QACnB,IAAI,CAAC;YACH,qBAAqB;YACrB,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,iCAAsB,EAAE,KAAK,IAA8B,EAAE;gBACzF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;gBAC5B,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,6BAA6B,CAAC,CAAA;gBAEhD,IAAI,CAAC;oBACH,MAAM,MAAM,GAAoB;wBAC9B,KAAK,EAAE;4BACL;gCACE,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI;gCAC5B,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,WAAW;gCAC1C,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,WAAW;6BAC3C;yBACF;qBACF,CAAA;oBAED,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,8BAA8B,EAAE;wBAChD,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;wBACpC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;qBAC/B,CAAC,CAAA;oBAEF,OAAO,MAAM,CAAA;gBACf,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,2BAA2B,EAAE;wBAC7C,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;wBACpC,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;qBAC9D,CAAC,CAAA;oBACF,MAAM,KAAK,CAAA;gBACb,CAAC;YACH,CAAC,CAAC,CAAA;YAEF,oBAAoB;YACpB,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAC3B,gCAAqB,EACrB,KAAK,EAAE,OAAO,EAA2B,EAAE;gBACzC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;gBAC5B,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAA;gBAC1B,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,4BAA4B,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;gBAEtE,IAAI,CAAC;oBACH,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;wBAChC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;wBAEhE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,0BAA0B,EAAE;4BAC3C,IAAI,EAAE,MAAM,CAAC,IAAI;4BACjB,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;4BACpC,OAAO,EAAE,IAAI;yBACd,CAAC,CAAA;wBAEF,OAAO,MAAwB,CAAA;oBACjC,CAAC;oBAED,MAAM,IAAI,8BAAe,CAAC,iBAAiB,MAAM,CAAC,IAAI,EAAE,EAAE,cAAc,CAAC,CAAA;gBAC3E,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,uBAAuB,EAAE;wBACzC,IAAI,EAAE,MAAM,CAAC,IAAI;wBACjB,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;wBACpC,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;qBAC9D,CAAC,CAAA;oBACF,MAAM,KAAK,CAAA;gBACb,CAAC;YACH,CAAC,CACF,CAAA;YAED,yBAAyB;YACzB,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAC3B,qCAA0B,EAC1B,KAAK,IAAkC,EAAE;gBACvC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;gBAC5B,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,iCAAiC,CAAC,CAAA;gBAEpD,IAAI,CAAC;oBACH,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,aAAa,EAAE,CAAA;oBAE3D,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,kCAAkC,EAAE;wBACpD,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;wBACpC,aAAa,EAAE,SAAS,CAAC,MAAM;qBAChC,CAAC,CAAA;oBAEF,OAAO,EAAE,SAAS,EAAE,CAAA;gBACtB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,+BAA+B,EAAE;wBACjD,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;wBACpC,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;qBAC9D,CAAC,CAAA;oBACF,MAAM,KAAK,CAAA;gBACb,CAAC;YACH,CAAC,CACF,CAAA;YAED,wBAAwB;YACxB,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAC3B,oCAAyB,EACzB,KAAK,EAAE,OAAO,EAA+B,EAAE;gBAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;gBAC5B,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAA;gBAC1B,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,gCAAgC,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAA;gBAExE,IAAI,CAAC;oBACH,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,kBAAkB,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;wBACxD,MAAM,IAAI,8BAAe,CACvB,yBAAyB,MAAM,CAAC,GAAG,EAAE,EACrC,sBAAsB,CACvB,CAAA;oBACH,CAAC;oBAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;oBAEjE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,iCAAiC,EAAE;wBACnD,GAAG,EAAE,MAAM,CAAC,GAAG;wBACf,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;wBACpC,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;qBACrD,CAAC,CAAA;oBAEF,OAAO,MAAuC,CAAA;gBAChD,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,8BAA8B,EAAE;wBAChD,GAAG,EAAE,MAAM,CAAC,GAAG;wBACf,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;wBACpC,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;qBAC9D,CAAC,CAAA;oBACF,MAAM,KAAK,CAAA;gBACb,CAAC;YACH,CAAC,CACF,CAAA;YAED,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,sCAAsC,CAAC,CAAA;QAC3D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,8BAA8B,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;YAC3E,MAAM,IAAI,uBAAQ,CAAC,8BAA8B,EAAE,uBAAuB,CAAC,CAAA;QAC7E,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,aAAa;QACX,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;YAC5B,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa;SACnC,CAAA;IACH,CAAC;IAED;;;OAGG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,SAAS,KAAK,IAAI,CAAA;IAChC,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,YAAY,EAAE,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAA;IACpD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;gBACpB,MAAM,IAAI,uBAAQ,CAAC,8BAA8B,EAAE,kBAAkB,CAAC,CAAA;YACxE,CAAC;YAED,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACpB,MAAM,IAAI,uBAAQ,CAAC,0BAA0B,EAAE,0BAA0B,CAAC,CAAA;YAC5E,CAAC;YAED,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAA;YAE1C,8BAA8B;YAC9B,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YAEzC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,iCAAiC,EAAE;gBAClD,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;gBAClC,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa;aACzC,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,4BAA4B,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;YACzE,MAAM,KAAK,YAAY,uBAAQ;gBAC7B,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,IAAI,uBAAQ,CAAC,4BAA4B,EAAE,qBAAqB,CAAC,CAAA;QACvE,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS;QACb,OAAO;YACL;gBACE,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI;gBAC5B,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,WAAW;gBAC1C,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,WAAW;aAC3C;SACF,CAAA;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,aAAa;QACjB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,aAAa,EAAE,CAAA;QAC3D,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAClC,GAAG,EAAE,QAAQ,CAAC,GAAG;YACjB,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,WAAW,EAAE,QAAQ,CAAC,WAAW;SAClC,CAAC,CAAC,CAAA;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,QAAgB,EAAE,MAAe;QAC9C,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;YAC7B,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QAChD,CAAC;QACD,MAAM,IAAI,8BAAe,CAAC,iBAAiB,QAAQ,EAAE,EAAE,cAAc,CAAC,CAAA;IACxE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,YAAY,CAAC,GAAW;QAC5B,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;YACjD,MAAM,IAAI,8BAAe,CAAC,yBAAyB,GAAG,EAAE,EAAE,sBAAsB,CAAC,CAAA;QACnF,CAAC;QACD,OAAO,MAAM,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,GAAG,CAAC,CAAA;IACpD,CAAC;IAED;;;;OAIG;IACH,cAAc;QAIZ,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,aAAa,EAAE;YAChC,cAAc,EAAE,IAAI,CAAC,YAAY,CAAC,iBAAiB,EAAE;SACtD,CAAA;IACH,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAA;IAC7C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAA;YAE/C,uCAAuC;YACvC,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,EAAE,CAAA;YACnC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,yBAAyB,EAAE;gBAC1C,cAAc,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAC9D,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,EAC/B,CAAC,CACF;aACF,CAAC,CAAA;YAEF,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;YAC3B,CAAC;YAED,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,+BAA+B,CAAC,CAAA;QACnD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,8BAA8B,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;YAC3E,MAAM,IAAI,uBAAQ,CAAC,0CAA0C,EAAE,wBAAwB,CAAC,CAAA;QAC1F,CAAC;IACH,CAAC;CACF;AA3ZD,8BA2ZC"}
+{"version":3,"file":"McpServer.js","sourceRoot":"","sources":["../../src/server/McpServer.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAEH,wEAAkE;AAClE,wEAAgF;AAChF,iEAS2C;AAC3C,0DAAsD;AAEtD,+DAAkF;AAClF,iEAA6D;AAC7D,+DAA2D;AAC3D,yDAAqD;AACrD,yDAAkE;AAClE,6CAAyC;AAezC;;GAEG;AACH,MAAa,SAAS;IAUpB;;;;OAIG;IACH,YAAY,MAAoB;QAbxB,cAAS,GAAgC,IAAI,CAAA;QAcnD,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAA;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QAEpB,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,yBAAyB,EAAE;YAC1C,IAAI,EAAE,MAAM,CAAC,UAAU;YACvB,OAAO,EAAE,MAAM,CAAC,aAAa;SAC9B,CAAC,CAAA;QAEF,yCAAyC;QACzC,IAAI,CAAC,YAAY,GAAG,IAAI,2BAAY,CAAC,MAAM,CAAC,CAAA;QAE5C,gEAAgE;QAChE,MAAM,eAAe,GAAG,IAAA,qCAAqB,EAAC,MAAM,CAAC,SAAS,EAAE;YAC9D,gBAAgB,EAAE,MAAM,CAAC,kBAAkB,EAAE,mDAAmD;SACjG,CAAC,CAAA;QAEF,2CAA2C;QAC3C,MAAM,cAAc,GAAG,IAAI,eAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QAElD,IAAI,CAAC,aAAa,GAAG,IAAI,6BAAa,CAAC,eAAe,EAAE,cAAc,CAAC,CAAA;QAEvE,6DAA6D;QAC7D,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;YAC1B,IAAI,CAAC,cAAc,GAAG,IAAI,+BAAc,CAAC;gBACvC,OAAO,EAAE,MAAM,CAAC,cAAc;gBAC9B,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,aAAa,EAAE,MAAM,CAAC,oBAAoB;aAC3C,CAAC,CAAA;YACF,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,4BAA4B,EAAE;gBAC7C,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,aAAa,EAAE,MAAM,CAAC,oBAAoB;aAC3C,CAAC,CAAA;QACJ,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAA;QACjD,CAAC;QAED,IAAI,CAAC,YAAY,GAAG,IAAI,2BAAY,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,cAAc,CAAC,CAAA;QAChG,IAAI,CAAC,cAAc,GAAG,IAAI,+BAAc,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QAE3D,0CAA0C;QAC1C,IAAI,CAAC,MAAM,GAAG,IAAI,iBAAM,CACtB;YACE,IAAI,EAAE,MAAM,CAAC,UAAU;YACvB,OAAO,EAAE,MAAM,CAAC,aAAa;SAC9B,EACD;YACE,YAAY,EAAE;gBACZ,KAAK,EAAE,EAAE;gBACT,SAAS,EAAE,EAAE;aACd;SACF,CACF,CAAA;QAED,4DAA4D;QAC5D,IAAI,CAAC,cAAc,EAAE,CAAA;QAErB,qBAAqB;QACrB,IAAI,CAAC,aAAa,EAAE,CAAA;QAEpB,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,qCAAqC,CAAC,CAAA;IACzD,CAAC;IAED;;;;OAIG;IACK,cAAc,CAAC,MAAoB;QACzC,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAA;QAChD,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAChE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAA;QACnD,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACK,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,QAAkC;QAC9E,MAAM,SAAS,GAA6B;YAC1C,KAAK,EAAE,CAAC;YACR,IAAI,EAAE,CAAC;YACP,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,CAAC;SACT,CAAA;QAED,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxD,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;YAC1C,MAAM,QAAQ,GAAG;gBACf,SAAS;gBACT,KAAK;gBACL,OAAO;gBACP,OAAO,EAAE,YAAY;gBACrB,GAAG,QAAQ;aACZ,CAAA;YACD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAA;QACzC,CAAC;IACH,CAAC;IAED;;OAEG;IACK,cAAc;QACpB,IAAI,CAAC;YACH,IAAI,CAAC,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAA;YAC3C,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,8CAA8C,CAAC,CAAA;QACnE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,2BAA2B,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;YACxE,MAAM,IAAI,uBAAQ,CAAC,+BAA+B,EAAE,wBAAwB,CAAC,CAAA;QAC/E,CAAC;IACH,CAAC;IAED;;OAEG;IACK,aAAa;QACnB,IAAI,CAAC;YACH,qBAAqB;YACrB,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,iCAAsB,EAAE,KAAK,IAA8B,EAAE;gBACzF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;gBAC5B,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,6BAA6B,CAAC,CAAA;gBAEhD,IAAI,CAAC;oBACH,MAAM,MAAM,GAAoB;wBAC9B,KAAK,EAAE;4BACL;gCACE,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI;gCAC5B,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,WAAW;gCAC1C,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,WAAW;6BAC3C;yBACF;qBACF,CAAA;oBAED,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,8BAA8B,EAAE;wBAChD,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;wBACpC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;qBAC/B,CAAC,CAAA;oBAEF,OAAO,MAAM,CAAA;gBACf,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,2BAA2B,EAAE;wBAC7C,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;wBACpC,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;qBAC9D,CAAC,CAAA;oBACF,MAAM,KAAK,CAAA;gBACb,CAAC;YACH,CAAC,CAAC,CAAA;YAEF,oBAAoB;YACpB,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAC3B,gCAAqB,EACrB,KAAK,EAAE,OAAO,EAA2B,EAAE;gBACzC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;gBAC5B,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAA;gBAC1B,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,4BAA4B,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;gBAEtE,IAAI,CAAC;oBACH,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;wBAChC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;wBAEhE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,0BAA0B,EAAE;4BAC3C,IAAI,EAAE,MAAM,CAAC,IAAI;4BACjB,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;4BACpC,OAAO,EAAE,IAAI;yBACd,CAAC,CAAA;wBAEF,OAAO,MAAwB,CAAA;oBACjC,CAAC;oBAED,MAAM,IAAI,8BAAe,CAAC,iBAAiB,MAAM,CAAC,IAAI,EAAE,EAAE,cAAc,CAAC,CAAA;gBAC3E,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,uBAAuB,EAAE;wBACzC,IAAI,EAAE,MAAM,CAAC,IAAI;wBACjB,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;wBACpC,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;qBAC9D,CAAC,CAAA;oBACF,MAAM,KAAK,CAAA;gBACb,CAAC;YACH,CAAC,CACF,CAAA;YAED,yBAAyB;YACzB,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAC3B,qCAA0B,EAC1B,KAAK,IAAkC,EAAE;gBACvC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;gBAC5B,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,iCAAiC,CAAC,CAAA;gBAEpD,IAAI,CAAC;oBACH,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,aAAa,EAAE,CAAA;oBAE3D,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,kCAAkC,EAAE;wBACpD,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;wBACpC,aAAa,EAAE,SAAS,CAAC,MAAM;qBAChC,CAAC,CAAA;oBAEF,OAAO,EAAE,SAAS,EAAE,CAAA;gBACtB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,+BAA+B,EAAE;wBACjD,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;wBACpC,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;qBAC9D,CAAC,CAAA;oBACF,MAAM,KAAK,CAAA;gBACb,CAAC;YACH,CAAC,CACF,CAAA;YAED,wBAAwB;YACxB,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAC3B,oCAAyB,EACzB,KAAK,EAAE,OAAO,EAA+B,EAAE;gBAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;gBAC5B,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAA;gBAC1B,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,gCAAgC,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAA;gBAExE,IAAI,CAAC;oBACH,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,kBAAkB,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;wBACxD,MAAM,IAAI,8BAAe,CACvB,yBAAyB,MAAM,CAAC,GAAG,EAAE,EACrC,sBAAsB,CACvB,CAAA;oBACH,CAAC;oBAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;oBAEjE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,iCAAiC,EAAE;wBACnD,GAAG,EAAE,MAAM,CAAC,GAAG;wBACf,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;wBACpC,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;qBACrD,CAAC,CAAA;oBAEF,OAAO,MAAuC,CAAA;gBAChD,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,8BAA8B,EAAE;wBAChD,GAAG,EAAE,MAAM,CAAC,GAAG;wBACf,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;wBACpC,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;qBAC9D,CAAC,CAAA;oBACF,MAAM,KAAK,CAAA;gBACb,CAAC;YACH,CAAC,CACF,CAAA;YAED,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,sCAAsC,CAAC,CAAA;QAC3D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,8BAA8B,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;YAC3E,MAAM,IAAI,uBAAQ,CAAC,8BAA8B,EAAE,uBAAuB,CAAC,CAAA;QAC7E,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,aAAa;QACX,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;YAC5B,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa;SACnC,CAAA;IACH,CAAC;IAED;;;OAGG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,SAAS,KAAK,IAAI,CAAA;IAChC,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,YAAY,EAAE,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAA;IACpD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;gBACpB,MAAM,IAAI,uBAAQ,CAAC,8BAA8B,EAAE,kBAAkB,CAAC,CAAA;YACxE,CAAC;YAED,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACpB,MAAM,IAAI,uBAAQ,CAAC,0BAA0B,EAAE,0BAA0B,CAAC,CAAA;YAC5E,CAAC;YAED,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAA;YAE1C,8BAA8B;YAC9B,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YAEzC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,iCAAiC,EAAE;gBAClD,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;gBAClC,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa;aACzC,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,4BAA4B,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;YACzE,MAAM,KAAK,YAAY,uBAAQ;gBAC7B,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,IAAI,uBAAQ,CAAC,4BAA4B,EAAE,qBAAqB,CAAC,CAAA;QACvE,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS;QACb,OAAO;YACL;gBACE,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI;gBAC5B,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,WAAW;gBAC1C,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,WAAW;aAC3C;SACF,CAAA;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,aAAa;QACjB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,aAAa,EAAE,CAAA;QAC3D,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAClC,GAAG,EAAE,QAAQ,CAAC,GAAG;YACjB,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,WAAW,EAAE,QAAQ,CAAC,WAAW;SAClC,CAAC,CAAC,CAAA;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,QAAgB,EAAE,MAAe;QAC9C,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;YAC7B,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QAChD,CAAC;QACD,MAAM,IAAI,8BAAe,CAAC,iBAAiB,QAAQ,EAAE,EAAE,cAAc,CAAC,CAAA;IACxE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,YAAY,CAAC,GAAW;QAC5B,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;YACjD,MAAM,IAAI,8BAAe,CAAC,yBAAyB,GAAG,EAAE,EAAE,sBAAsB,CAAC,CAAA;QACnF,CAAC;QACD,OAAO,MAAM,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,GAAG,CAAC,CAAA;IACpD,CAAC;IAED;;;;OAIG;IACH,cAAc;QAIZ,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,aAAa,EAAE;YAChC,cAAc,EAAE,IAAI,CAAC,YAAY,CAAC,iBAAiB,EAAE;SACtD,CAAA;IACH,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAA;IAC7C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAA;YAE/C,uCAAuC;YACvC,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,EAAE,CAAA;YACnC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,yBAAyB,EAAE;gBAC1C,cAAc,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAC9D,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,EAC/B,CAAC,CACF;aACF,CAAC,CAAA;YAEF,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;YAC3B,CAAC;YAED,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,+BAA+B,CAAC,CAAA;QACnD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,8BAA8B,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;YAC3E,MAAM,IAAI,uBAAQ,CAAC,0CAA0C,EAAE,wBAAwB,CAAC,CAAA;QAC1F,CAAC;IACH,CAAC;CACF;AA5aD,8BA4aC"}

package/dist/session/SessionHistoryFormatter.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Session history formatter for LLM context
+ *
+ * Converts SessionData to Markdown format for optimal token efficiency and LLM comprehension.
+ */
+import type { SessionData } from '../types/SessionData';
+/**
+ * Formats session history as Markdown for LLM context.
+ *
+ * Extracts only the essential conversation flow (prompts and responses),
+ * removing metadata like sessionId, timestamps, and execution details.
+ *
+ * @param sessionData - Session data to format
+ * @returns Markdown-formatted conversation history
+ *
+ * @example
+ * ```typescript
+ * const history = formatSessionHistory(sessionData)
+ * // Output:
+ * // # Session History: rule-advisor
+ * //
+ * // ## 1. User Request
+ * //
+ * // Task: Fix TypeScript type errors
+ * //
+ * // ## 1. Agent Response
+ * //
+ * // To fix type errors...
+ * ```
+ */
+export declare function formatSessionHistory(sessionData: SessionData): string;
+//# sourceMappingURL=SessionHistoryFormatter.d.ts.map

package/dist/session/SessionHistoryFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionHistoryFormatter.d.ts","sourceRoot":"","sources":["../../src/session/SessionHistoryFormatter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAEvD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CA8BrE"}

package/dist/session/SessionHistoryFormatter.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * Session history formatter for LLM context
+ *
+ * Converts SessionData to Markdown format for optimal token efficiency and LLM comprehension.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatSessionHistory = formatSessionHistory;
+/**
+ * Formats session history as Markdown for LLM context.
+ *
+ * Extracts only the essential conversation flow (prompts and responses),
+ * removing metadata like sessionId, timestamps, and execution details.
+ *
+ * @param sessionData - Session data to format
+ * @returns Markdown-formatted conversation history
+ *
+ * @example
+ * ```typescript
+ * const history = formatSessionHistory(sessionData)
+ * // Output:
+ * // # Session History: rule-advisor
+ * //
+ * // ## 1. User Request
+ * //
+ * // Task: Fix TypeScript type errors
+ * //
+ * // ## 1. Agent Response
+ * //
+ * // To fix type errors...
+ * ```
+ */
+function formatSessionHistory(sessionData) {
+    const conversations = sessionData.history
+        .map((entry, index) => {
+        const number = index + 1;
+        // Extract only the 'result' field from agent response (removing metadata)
+        let agentResponse = entry.response.stdout;
+        try {
+            const parsed = JSON.parse(entry.response.stdout);
+            if (parsed && typeof parsed === 'object' && 'result' in parsed) {
+                agentResponse = String(parsed.result);
+            }
+        }
+        catch {
+            // If parsing fails, use the raw stdout as fallback
+            // This ensures backward compatibility and error resilience
+        }
+        return `## ${number}. User Request
+
+${entry.request.prompt}
+
+## ${number}. Agent Response
+
+${agentResponse}`;
+    })
+        .join('\n\n');
+    return `# Session History: ${sessionData.agentType}
+
+${conversations}`;
+}
+//# sourceMappingURL=SessionHistoryFormatter.js.map

package/dist/session/SessionHistoryFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionHistoryFormatter.js","sourceRoot":"","sources":["../../src/session/SessionHistoryFormatter.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AA4BH,oDA8BC;AAtDD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAgB,oBAAoB,CAAC,WAAwB;IAC3D,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO;SACtC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QACpB,MAAM,MAAM,GAAG,KAAK,GAAG,CAAC,CAAA;QAExB,0EAA0E;QAC1E,IAAI,aAAa,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAA;QACzC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;YAChD,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,QAAQ,IAAI,MAAM,EAAE,CAAC;gBAC/D,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;YACvC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,mDAAmD;YACnD,2DAA2D;QAC7D,CAAC;QAED,OAAO,MAAM,MAAM;;EAEvB,KAAK,CAAC,OAAO,CAAC,MAAM;;KAEjB,MAAM;;EAET,aAAa,EAAE,CAAA;IACb,CAAC,CAAC;SACD,IAAI,CAAC,MAAM,CAAC,CAAA;IAEf,OAAO,sBAAsB,WAAW,CAAC,SAAS;;EAElD,aAAa,EAAE,CAAA;AACjB,CAAC"}

package/dist/session/SessionManager.d.ts

@@ -0,0 +1,158 @@
+import type { SessionConfig, SessionData, SessionEntry } from '../types/SessionData';
+/**
+ * Session manager for handling session data persistence.
+ *
+ * Manages session data storage, retrieval, and cleanup operations.
+ * Ensures secure file handling with directory traversal prevention.
+ */
+export declare class SessionManager {
+    private readonly config;
+    /**
+     * Creates a new SessionManager instance.
+     *
+     * Initializes the session directory synchronously to ensure it exists
+     * before any operations are performed.
+     *
+     * @param config - Session configuration containing directory path and retention settings
+     */
+    constructor(config: SessionConfig);
+    /**
+     * Initializes the session directory by creating it if it doesn't exist.
+     * Uses synchronous file operations to ensure directory exists before returning.
+     *
+     * @private
+     * @throws {Error} If directory creation fails
+     */
+    private initializeSessionDirectory;
+    /**
+     * Validates a session ID to ensure it only contains allowed characters.
+     * Prevents directory traversal attacks by rejecting IDs with path manipulation characters.
+     *
+     * Session IDs must:
+     * - Not be empty
+     * - Contain only alphanumeric characters, hyphens (-), and underscores (_)
+     * - Not contain path traversal sequences (../, ./, etc.)
+     *
+     * @param sessionId - The session ID to validate
+     * @throws {Error} If the session ID contains invalid characters or is empty
+     */
+    validateSessionId(sessionId: string): void;
+    /**
+     * Builds a file path for a session file following the naming convention:
+     * [session_id]_[agent_type].json
+     *
+     * Security measures:
+     * - Validates session ID before processing
+     * - Uses path.basename to strip directory components
+     * - Verifies final path is within session directory
+     *
+     * @param sessionId - The session identifier (validated for security)
+     * @param agentType - The type of agent (e.g., 'rule-advisor', 'quality-fixer')
+     * @returns The full file path for the session file
+     * @throws {Error} If the session ID is invalid or if path traversal is detected
+     */
+    buildFilePath(sessionId: string, agentType: string): string;
+    /**
+     * Saves session data to a JSON file.
+     *
+     * If a session file already exists, the new request-response pair is appended
+     * to the existing history. Otherwise, a new session file is created.
+     *
+     * Error handling follows the error isolation principle:
+     * - Errors are logged but not thrown
+     * - The main execution flow continues even if session save fails
+     *
+     * Security features:
+     * - Session ID validation prevents directory traversal
+     * - File permissions are set to 0o600 (owner read/write only)
+     * - All file paths are verified to stay within session directory
+     *
+     * @param sessionId - The session identifier (alphanumeric, hyphens, underscores only)
+     * @param request - The request object containing agent, prompt, and optional parameters
+     * @param response - The response object containing stdout, stderr, exitCode, and executionTime
+     *
+     * @example
+     * await sessionManager.saveSession(
+     *   'session-001',
+     *   { agent: 'rule-advisor', prompt: 'Analyze code' },
+     *   { stdout: 'Analysis complete', stderr: '', exitCode: 0, executionTime: 100 }
+     * )
+     */
+    saveSession(sessionId: string, request: SessionEntry['request'], response: SessionEntry['response']): Promise<void>;
+    /**
+     * Builds session data by either creating a new session or appending to an existing one.
+     *
+     * @param sessionId - The session identifier
+     * @param agentType - The agent type
+     * @param sessionEntry - The new session entry to add
+     * @returns Complete session data ready to be saved
+     */
+    private buildSessionData;
+    /**
+     * Logs structured error information when session save fails.
+     *
+     * @param sessionId - The session identifier
+     * @param agentType - The agent type
+     * @param error - The error that occurred
+     */
+    private logSaveError;
+    /**
+     * Loads a session by session ID and agent type.
+     *
+     * Searches for the most recent session file matching the session ID and agent type.
+     * If multiple files exist with the same session ID and agent type, returns the one with the latest timestamp.
+     *
+     * **CRITICAL**: Sub-agent isolation is enforced - sessions are isolated by agent type.
+     * Same session_id with different agent_type will return different sessions.
+     *
+     * Error handling follows the error isolation principle:
+     * - Returns null if session file does not exist
+     * - Returns null if JSON parsing fails
+     * - Errors are logged but not thrown
+     *
+     * @param sessionId - The session identifier (alphanumeric, hyphens, underscores only)
+     * @param agentType - The agent type to filter sessions (e.g., 'rule-advisor', 'task-executor')
+     * @returns The session data if found, null otherwise
+     *
+     * @example
+     * const session = await sessionManager.loadSession('session-001', 'rule-advisor')
+     * if (session) {
+     *   console.log(`Loaded session with ${session.history.length} entries`)
+     * }
+     */
+    loadSession(sessionId: string, agentType: string): Promise<SessionData | null>;
+    /**
+     * Loads an existing session file if it exists.
+     *
+     * Searches for the most recent session file matching the session ID and agent type.
+     *
+     * @param sessionId - The session identifier
+     * @param agentType - The agent type
+     * @returns The session data if found, null otherwise
+     */
+    private loadExistingSession;
+    /**
+     * Logs structured error information when session load fails.
+     *
+     * @param sessionId - The session identifier
+     * @param error - The error that occurred
+     */
+    private logLoadError;
+    /**
+     * Cleans up old session files based on retention period.
+     *
+     * Deletes session files older than the configured retention period (default 7 days).
+     * This is a best-effort operation - errors during deletion are logged but not thrown.
+     *
+     * Error handling follows the error isolation principle:
+     * - Individual file deletion failures do not stop the cleanup process
+     * - All errors are logged for debugging purposes
+     * - The method completes successfully even if some files cannot be deleted
+     *
+     * @example
+     * // Cleanup old sessions (runs silently, logs errors only)
+     * await sessionManager.cleanupOldSessions()
+     */
+    cleanupOldSessions(): Promise<void>;
+}
+//# sourceMappingURL=SessionManager.d.ts.map

package/dist/session/SessionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionManager.d.ts","sourceRoot":"","sources":["../../src/session/SessionManager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAEpF;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IAEtC;;;;;;;OAOG;gBACS,MAAM,EAAE,aAAa;IAKjC;;;;;;OAMG;IACH,OAAO,CAAC,0BAA0B;IAalC;;;;;;;;;;;OAWG;IACI,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAcjD;;;;;;;;;;;;;OAaG;IACI,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IA0BlE;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACU,WAAW,CACtB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,EAChC,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC;IA6BhB;;;;;;;OAOG;YACW,gBAAgB;IA0B9B;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IASpB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACU,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAoC3F;;;;;;;;OAQG;YACW,mBAAmB;IAkCjC;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAQpB;;;;;;;;;;;;;;OAcG;IACU,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;CAmEjD"}