agent-orchestrator-mcp-server 0.4.6 → 0.4.7
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.
package/package.json
CHANGED
|
@@ -46,7 +46,7 @@ export declare function getSessionTool(_server: Server, clientFactory: () => IAg
|
|
|
46
46
|
};
|
|
47
47
|
include_transcript: {
|
|
48
48
|
type: string;
|
|
49
|
-
description: "Include the full transcript
|
|
49
|
+
description: "Include the full transcript inline. Default: false. WARNING: can be very large and may overwhelm your context window. When false, the transcript file path is returned instead so you can grep/tail it efficiently (see tool description for tips).";
|
|
50
50
|
};
|
|
51
51
|
transcript_format: {
|
|
52
52
|
type: string;
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
2
|
const PARAM_DESCRIPTIONS = {
|
|
3
3
|
id: 'Session ID (numeric) or slug (string). Examples: "1", "fix-auth-bug-20250115"',
|
|
4
|
-
include_transcript: 'Include the full transcript
|
|
4
|
+
include_transcript: 'Include the full transcript inline. Default: false. WARNING: can be very large and may overwhelm your context window. When false, the transcript file path is returned instead so you can grep/tail it efficiently (see tool description for tips).',
|
|
5
5
|
transcript_format: 'Format for transcript retrieval: "text" (human-readable) or "json" (structured). Only used when include_transcript is true. When specified, fetches transcript via dedicated endpoint instead of inline.',
|
|
6
6
|
include_logs: 'Include logs for the session. Default: false. Use logs_page and logs_per_page for pagination.',
|
|
7
7
|
logs_page: 'Page number for logs pagination. Default: 1',
|
|
@@ -35,10 +35,12 @@ export const GetSessionSchema = z.object({
|
|
|
35
35
|
const TOOL_DESCRIPTION = `Get detailed information about a specific agent session.
|
|
36
36
|
|
|
37
37
|
**Returns:** Complete session details including status, configuration, metadata, and optionally:
|
|
38
|
-
- Full session transcript
|
|
38
|
+
- Full session transcript (WARNING: can be very large)
|
|
39
39
|
- Session logs (paginated)
|
|
40
40
|
- Subagent transcripts (paginated)
|
|
41
41
|
|
|
42
|
+
**Transcript access:** By default (include_transcript=false), the response includes the transcript file path instead of the full content. You can then efficiently grep, tail, or read specific sections of that file — for example, read the last ~100 lines to see the most recent messages. This avoids overwhelming your context window with massive transcripts.
|
|
43
|
+
|
|
42
44
|
**Use cases:**
|
|
43
45
|
- View detailed session information
|
|
44
46
|
- Check session status and progress (use transcript to determine if a "needs_input" session has completed its task or needs follow-up)
|
|
@@ -114,6 +116,14 @@ function formatSessionDetails(session, includeTranscript) {
|
|
|
114
116
|
lines.push(session.transcript);
|
|
115
117
|
lines.push('```');
|
|
116
118
|
}
|
|
119
|
+
// When transcript is not included inline, provide file path hints for efficient access
|
|
120
|
+
if (!includeTranscript && session.session_id) {
|
|
121
|
+
lines.push('');
|
|
122
|
+
lines.push('### Transcript File');
|
|
123
|
+
lines.push(`- **Path pattern:** \`~/.claude/projects/*/${session.session_id}.jsonl\``);
|
|
124
|
+
lines.push(`- **Find exact path:** \`ls ~/.claude/projects/*/${session.session_id}.jsonl\``);
|
|
125
|
+
lines.push('- **Tip:** Once you have the exact path, read the last ~100 lines to see the most recent messages, or grep for specific keywords. This avoids loading the entire transcript into your context window.');
|
|
126
|
+
}
|
|
117
127
|
return lines.join('\n');
|
|
118
128
|
}
|
|
119
129
|
function formatLogs(logs, pagination) {
|