sub-agents-mcp 0.1.4 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (36) hide show
  1. package/README.md +253 -140
  2. package/dist/config/ServerConfig.d.ts +9 -0
  3. package/dist/config/ServerConfig.d.ts.map +1 -1
  4. package/dist/config/ServerConfig.js +17 -0
  5. package/dist/config/ServerConfig.js.map +1 -1
  6. package/dist/server/McpServer.d.ts +1 -0
  7. package/dist/server/McpServer.d.ts.map +1 -1
  8. package/dist/server/McpServer.js +18 -2
  9. package/dist/server/McpServer.js.map +1 -1
  10. package/dist/session/SessionHistoryFormatter.d.ts +32 -0
  11. package/dist/session/SessionHistoryFormatter.d.ts.map +1 -0
  12. package/dist/session/SessionHistoryFormatter.js +62 -0
  13. package/dist/session/SessionHistoryFormatter.js.map +1 -0
  14. package/dist/session/SessionManager.d.ts +158 -0
  15. package/dist/session/SessionManager.d.ts.map +1 -0
  16. package/dist/session/SessionManager.js +410 -0
  17. package/dist/session/SessionManager.js.map +1 -0
  18. package/dist/session/ToonConverter.d.ts +172 -0
  19. package/dist/session/ToonConverter.d.ts.map +1 -0
  20. package/dist/session/ToonConverter.js +593 -0
  21. package/dist/session/ToonConverter.js.map +1 -0
  22. package/dist/session/ToonUtils.d.ts +23 -0
  23. package/dist/session/ToonUtils.d.ts.map +1 -0
  24. package/dist/session/ToonUtils.js +75 -0
  25. package/dist/session/ToonUtils.js.map +1 -0
  26. package/dist/tools/RunAgentTool.d.ts +62 -4
  27. package/dist/tools/RunAgentTool.d.ts.map +1 -1
  28. package/dist/tools/RunAgentTool.js +223 -46
  29. package/dist/tools/RunAgentTool.js.map +1 -1
  30. package/dist/types/SessionData.d.ts +63 -0
  31. package/dist/types/SessionData.d.ts.map +1 -0
  32. package/dist/types/SessionData.js +3 -0
  33. package/dist/types/SessionData.js.map +1 -0
  34. package/dist/utils/Logger.js +2 -2
  35. package/dist/utils/Logger.js.map +1 -1
  36. package/package.json +1 -1
@@ -0,0 +1,63 @@
1
+ /**
2
+ * Session information
3
+ *
4
+ * Maintains historical request-response records from sub-agent executions.
5
+ * Autonomously managed by the MCP server and shared across multiple clients.
6
+ */
7
+ export interface SessionData {
8
+ /** Only alphanumerics, hyphens, and underscores are allowed to prevent directory traversal attacks. */
9
+ sessionId: string;
10
+ agentType: string;
11
+ history: SessionEntry[];
12
+ /** Used to determine retention period during cleanup processing. */
13
+ createdAt: Date;
14
+ lastUpdatedAt: Date;
15
+ }
16
+ /**
17
+ * Session history entry
18
+ *
19
+ * A request-response pair from a single sub-agent execution.
20
+ */
21
+ export interface SessionEntry {
22
+ timestamp: Date;
23
+ /** Has a structure compatible with ExecutionParams. */
24
+ request: {
25
+ agent: string;
26
+ prompt: string;
27
+ cwd?: string;
28
+ extra_args?: string[];
29
+ };
30
+ /** Has a structure compatible with ExecutionResult. */
31
+ response: {
32
+ stdout: string;
33
+ stderr: string;
34
+ exitCode: number;
35
+ executionTime: number;
36
+ };
37
+ }
38
+ /**
39
+ * Session configuration
40
+ *
41
+ * Loaded from environment variables and used during SessionManager initialization.
42
+ */
43
+ export interface SessionConfig {
44
+ /** Controlled by the SESSION_ENABLED environment variable. */
45
+ enabled: boolean;
46
+ /** Controlled by the SESSION_DIR environment variable. */
47
+ sessionDir: string;
48
+ /** Controlled by the SESSION_RETENTION_DAYS environment variable. */
49
+ retentionDays: number;
50
+ }
51
+ /**
52
+ * Session save result
53
+ *
54
+ * Due to error isolation design, main flow processing continues even if save fails.
55
+ */
56
+ export interface SessionSaveResult {
57
+ success: boolean;
58
+ sessionId: string;
59
+ /** File naming convention: [session_id]_[agent_type]_[timestamp].json */
60
+ filePath?: string;
61
+ error?: string;
62
+ }
63
+ //# sourceMappingURL=SessionData.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SessionData.d.ts","sourceRoot":"","sources":["../../src/types/SessionData.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,uGAAuG;IACvG,SAAS,EAAE,MAAM,CAAA;IAEjB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,YAAY,EAAE,CAAA;IAEvB,oEAAoE;IACpE,SAAS,EAAE,IAAI,CAAA;IAEf,aAAa,EAAE,IAAI,CAAA;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,IAAI,CAAA;IAEf,uDAAuD;IACvD,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,EAAE,MAAM,CAAA;QACd,GAAG,CAAC,EAAE,MAAM,CAAA;QACZ,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;KACtB,CAAA;IAED,uDAAuD;IACvD,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,CAAA;QACd,MAAM,EAAE,MAAM,CAAA;QACd,QAAQ,EAAE,MAAM,CAAA;QAChB,aAAa,EAAE,MAAM,CAAA;KACtB,CAAA;CACF;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,8DAA8D;IAC9D,OAAO,EAAE,OAAO,CAAA;IAEhB,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAA;IAElB,qEAAqE;IACrE,aAAa,EAAE,MAAM,CAAA;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IAEjB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf"}
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ //# sourceMappingURL=SessionData.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SessionData.js","sourceRoot":"","sources":["../../src/types/SessionData.ts"],"names":[],"mappings":""}
@@ -95,10 +95,10 @@ class Logger {
95
95
  // Format output for console readability
96
96
  const formattedMessage = `[${timestamp}] ${level.toUpperCase()}: ${message}`;
97
97
  if (context && Object.keys(context).length > 0) {
98
- console.log(formattedMessage, context);
98
+ console.error(formattedMessage, context);
99
99
  }
100
100
  else {
101
- console.log(formattedMessage);
101
+ console.error(formattedMessage);
102
102
  }
103
103
  // Optional file output in JSON format
104
104
  if (this.logFilePath) {
@@ -1 +1 @@
1
- {"version":3,"file":"Logger.js","sourceRoot":"","sources":["../../src/utils/Logger.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"Logger.js","sourceRoot":"","sources":["../../src/utils/Logger.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "sub-agents-mcp",
3
- "version": "0.1.4",
3
+ "version": "0.2.0",
4
4
  "mcpName": "io.github.shinpr/sub-agents-mcp",
5
5
  "description": "MCP server for delegating tasks to specialized AI assistants in Cursor and other tools",
6
6
  "main": "dist/index.js",