get_next_step_history
Retrieve complete history of a project's next step, including session details and handoff information, to track workflow progression and maintain context during transitions.
Instructions
Get complete history of a next step including session and handoff
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| projectId | Yes | Project identifier | |
| stepId | Yes | Next step ID |
Implementation Reference
- src/index.ts:258-274 (handler)Core handler function in ProjectManager that loads project data, finds the specified next step, its associated working session, and handoff, then returns them.
async getNextStepHistory(projectId: string, stepId: string): Promise<{ step: NextStep; session?: WorkingSession; handoff?: Handoff; }> { const data = await this.loadProjectData(projectId); const step = data.nextSteps.find(s => s.id === stepId); if (!step) { throw new ProjectError(`Next step not found: ${stepId}`, projectId); } const session = data.workingSessions.find(s => s.nextStepId === stepId); const handoff = session ? data.handoffs.find(h => h.sessionId === session.id) : undefined; return { step, session, handoff }; } - src/index.ts:394-405 (registration)Tool registration in the listTools response, defining name, description, and input schema.
{ name: "get_next_step_history", description: "Get complete history of a next step including session and handoff", inputSchema: { type: "object", properties: { projectId: { type: "string", description: "Project identifier" }, stepId: { type: "string", description: "Next step ID" } }, required: ["projectId", "stepId"] } } - src/index.ts:397-404 (schema)Input schema definition for the get_next_step_history tool, specifying required projectId and stepId parameters.
inputSchema: { type: "object", properties: { projectId: { type: "string", description: "Project identifier" }, stepId: { type: "string", description: "Next step ID" } }, required: ["projectId", "stepId"] } - src/index.ts:508-518 (handler)Dispatcher in CallToolRequestSchema handler that invokes the ProjectManager method and formats the response.
case "get_next_step_history": const history = await projectManager.getNextStepHistory( args.projectId as string, args.stepId as string ); return { content: [{ type: "text", text: JSON.stringify(history, null, 2) }] };