Function handleSnapshotList

packages/mcp/src/tools/snapshots.ts:210–263

(args: Record<string, unknown>)

]

async function handleSnapshotList(args: Record<string, unknown>) {
  if (args.path === undefined) {
    return snapshotError('path is required')
  }
  const parsedArgs = snapshotListArgsSchema.safeParse(args)
  if (!parsedArgs.success) {
    return snapshotError(`Invalid arguments for deepnote_snapshot_list: ${formatFirstIssue(parsedArgs.error)}`)
  }
  const { path: filePath, snapshotDir } = parsedArgs.data

  try {
    const absolutePath = path.resolve(filePath)
    const projectDir = path.dirname(absolutePath)

    // Read file to get the project ID
    const content = await fs.readFile(absolutePath, 'utf-8')
    const file = deserializeDeepnoteFile(content)
    const projectId = file.project.id

    const notebookId = resolveSnapshotNotebookId(file)
    const snapshotOptions = { ...(snapshotDir ? { snapshotDir } : {}), ...(notebookId ? { notebookId } : {}) }
    const snapshots = await findSnapshotsForProject(projectDir, projectId, snapshotOptions)
    const resolvedSnapshotDir = snapshotDir ? snapshotDir : path.join(projectDir, 'snapshots')

    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(
            {
              sourcePath: absolutePath,
              snapshotDir: resolvedSnapshotDir,
              snapshotsFound: snapshots.length,
              snapshots: snapshots.map(s => ({
                path: s.path,
                slug: s.slug,
                projectId: s.projectId,
                timestamp: s.timestamp,
                isLatest: s.timestamp === 'latest',
              })),
            },
            null,
            2
          ),
        },
      ],
    }
  } catch (error) {
    const message = error instanceof Error ? error.message : String(error)
    return {
      content: [{ type: 'text', text: JSON.stringify({ error: message }) }],
    }
  }
}

async function handleSnapshotLoad(args: Record<string, unknown>) {
  if (args.path === undefined) {