Function getFixAndDocumentPrompt

packages/mcp/src/prompts.ts:266–302

(args: Record<string, string> | undefined)

}

function getFixAndDocumentPrompt(args: Record<string, string> | undefined): GetPromptResult {
  const notebookPath = args?.notebook_path || 'notebook.deepnote'

  return {
    description: 'Workflow for fixing and documenting a notebook',
    messages: [
      {
        role: 'user',
        content: {
          type: 'text',
          text: `Fix issues and add documentation to: ${notebookPath}

Follow this workflow:

1. **Check for issues**:
   Use ${TOOL_NAMES.read} with include: ["lint", "dag"] to identify:
   - Undefined variables
   - Missing imports
   - Circular dependencies

2. **Inspect and fix affected blocks**:
   Use ${TOOL_NAMES.cat} path: "${notebookPath}" blockId: "<failed-or-flagged-block-id>"
   Then use ${TOOL_NAMES.editBlock} to apply fixes.

3. **Add documentation and structure**:
   Use ${TOOL_NAMES.addBlock} to add:
   - Markdown explanations before code blocks
   - Section headers to organize the notebook

4. **Re-run and verify**:
   Use ${TOOL_NAMES.run} and inspect results with ${TOOL_NAMES.snapshotLoad}.
   Use ${TOOL_NAMES.snapshotList} to review output history between runs.`,
        },
      },
    ],
  }
}

function getBlockTypesReferencePrompt(): GetPromptResult {
  return {