read_output
Retrieve terminal output from active processes to monitor command execution results in real-time.
Instructions
Read new output from a running terminal session.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pid | Yes |
Implementation Reference
- src/tools/execute.ts:30-45 (handler)The core handler function for the 'read_output' tool. Parses input arguments using ReadOutputArgsSchema, retrieves new output from terminalManager.getNewOutput(pid), and returns formatted text content or error message if no session.
export async function readOutput(args: unknown) { const parsed = ReadOutputArgsSchema.safeParse(args); if (!parsed.success) { throw new Error(`Invalid arguments for read_output: ${parsed.error}`); } const output = terminalManager.getNewOutput(parsed.data.pid); return { content: [{ type: "text", text: output === null ? `No session found for PID ${parsed.data.pid}` : output || 'No new output available' }], }; } - src/tools/schemas.ts:9-11 (schema)Zod input schema for 'read_output' tool requiring a single 'pid' property of type number.
export const ReadOutputArgsSchema = z.object({ pid: z.number(), }); - src/server.ts:66-71 (registration)Tool specification registration in ListToolsRequestHandler, providing name, description, and JSON schema derived from ReadOutputArgsSchema.
{ name: "read_output", description: "Read new output from a running terminal session.", inputSchema: zodToJsonSchema(ReadOutputArgsSchema), }, - src/server.ts:220-223 (registration)Dispatch case in CallToolRequestHandler that parses arguments with ReadOutputArgsSchema and invokes the readOutput handler function.
case "read_output": { const parsed = ReadOutputArgsSchema.parse(args); return readOutput(parsed); }